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WonderWitch の 世界 へ よう こそ ! 


現在 の ゲー ム 業 界 、 コ ンピュータ 業界 を めぐ る 状況 は 目まぐるしく 変化 し て いま す 。 
ハー ド ウェ ア や ソフ トウ ェ ア は 急激 に 高 性 能 化し 、 美しい 映像 や 音声 に よっ て 、 さ な が 
ら 映画 の よう に 完成 され た コン テン ツ が 提供 され て き て いま す 。 

し か し 、 こ うし た すばらし い コ ン テ ン ツ が 得 ら れる よう に な っ た 反面 、 個人 が 気軽 に 
趣味 の 範囲 で ゲー ム を 作っ た り 、 自作 ハー ド ウェ ア を 制御 する と いっ た 、 いわ ゆず ホ 
ビー 的 な 」 楽し み 方 は な か な か で き な く な っ て き て いま す 。 

ゲー ム マ シン は ゲー ム に 特 化 し た コン ピュ ー タ で す が 、 本 来 コ ンピュータ は 自由 な 発 
想 に 基づい て さま ざま な 可能 性 を 実現 する 、 いわ ば 創造 」 の た め の 道 具 な の で す 。 

私 た ち は 、 WonderSwan と いう 絶妙 な バラ ンス 感覚 で つく られ た ハー ド ウェア を 得 て 、 
これ を 消費 」 の た め だ け で な ぐ 創造 」 の た め に 使う 道具 と し て WonderWitch を 開発 
し まし た 。 ここ で いう 創造 」 に は 、 ゲ ー ム や プロ グラ ム の 開発 は も ちろ ん の こと 、 
WonderSwan を 取り 巻く 人 と 人 と の コミ ュ ニ ケー ショ ン を 創り 出す こと も 含ま れ て いま す 。 

そし て 、 その よう が 創造 」 の た め の 世 界 妊 ホビ ー プ ログ ラミ ング ワー ルド 」 と 名 づけ 
まし た だ 。 


・ ユ ー ザ それ ぞ れ の や り 方 や 価値 観 で 、 気楽 に 取り 組む こと の で きず ホビ ー」 

・ 自 分 の 手 や 頭 を 使っ て 工夫 し 創り だ し て い <「 プロ グラ ミン グ 」 

・ 作り 手 、 使い 手 、 友達 、 仲間 、 イ ンタ ーネット 、 コミ ュ ニ ティ な ど 、 多く の 人 や 技術 
や 文化 が , さま ざま な つなが り を 生み 出し な が ら 広 が っ て い <「 ワー ルド 」 


ホビ ー プ ログ ラミ ング ワー ルド で は 、 WonderWitch に よっ て WonderSwan が 優れ た 
スモ ー ル コン ピュ ー タ に 変身 し ます 。 


・ ひ と り で すみ ずみ まで 見 渡す こと が で きる ハー ド ウェ ア 
電池 1 本 で 動作 し 、 ポ ケット に 納まる 携帯 性 

・10 年 前 の 同等 な 性 能 を 持つ コン ピュ ー タ の 100 分 の 1 の 価格 

・ 先進 的 な 技術 と 非常 に 高い 柔軟 性 を も つ シ ステ ム ソ フ ト ウェ ア 

・ ユ ー ザ の 自由 な 発想 に よる プロ グラ ム の 作成 と 実行 

ホビ ー プ ログ ラミ ング ワー ルド の 発展 は 、 WonderWitch を 手 に し た ユー ザ ひ と り ひ 
と り に か か っ て いま す 。 これ を 手 に し た あな た が どん な 魔法 を 披露 し て くれ る の か 楽し 
み に し て いま す 。 


さあ 、 扉 は 開か れ ま し た 。 よう こそ 、 魔法 の 国 ホビ ー プ ログ ラミ ング ワー ルド ) へ ! 
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第 1 部 
ユー ザー ズ マ ニュ アル 了 M 


Yetoxib ん Fl 


葛 1 草 
は じ め に お 読み くだ さい 


1.1 本 書 に つい て 


本 書 は J ユー ザー ズ マ ニュ アル 」』 デベ ロッ パー ズ マ ニュ アル 」 の 2 部 で 構成 され て 
いま す 。 ユー ザー ズ マ ニュ アル で は 、 セッ ト ア ッ プ 方法 、 WonderSwan で の 操作 、 ファ 
イル 転送 ツー ル の 使用 方 法 な ど 、 WonderWitch を 使用 する の に 必要 な 情報 を 説明 
し て いま す 。 デベ ロッ パー ズ マ ニュ アル で は 、 アー キテ クチ ャ 、 チュ ー ト リア ル な ど 、 プロ 
グラ ミン グ に 必要 な 情報 を 説明 し て いま す 。 また 付録 に は 各種 リフ ァ レ ンス を 収録 し て 
いま す 。 


注意 : 本 製品 を 使用 する 前 に 、 当 冊 子 冒 頭 に ある ソフ トウ ェ ア 使用 許諾 契約 書 を よく お 読み くだ さい 。 内 容 に 同 
意 さ れ た 方 の み 本 製品 を ご 使用 くだ さい 。 


1.2 パッ ケー ジ 内 容 物 の 確認 


製品 パッ ケー ジ に は 次 の も の が 含ま れ ま す 。 開封 時 に 不足 や 破損 が あっ た 場合 に 
は 、 バン ダイ お客様 相談 セン ター まで 連絡 し て くだ さい 。 


圏 WonderWitch 専 用 カー トリ ッ ジ 1 個 


は じ め に お 読み くだ さい 


固 PC - WonderSwan 接 続 ケ ー ブ ル (RS232C こ シリ アル 接続 ) 1 組 


・ ス ワン ケー ブル : EXT コ ネ ク タ 々 @ DSUB-@ オス ) 1 本 


・ ク ロス ケー ブル : DSUB-@ メス )@ DSUB-@ メス ) 1 本 


田 Magical CD-ROM 1 枚 


画 取 扱 説明 書 1 民 当 民 子 ) 


1.3 カー トリ ッ ジ の 装着 お よび ケー ブル の 接続 方 法 


WonderWitch 専 用 カー トリ ッ ジ の 装着 お よび ケー ブル の 接続 時 は 、 必ず Wonder 
Swan 本 体 の 電源 お よび PC の 電源 を 切っ て か ら 行っ て くだ さい 。 


1.3.1 カー トリ ッ ジ の 装着 
WonderWitch 専 用 カー トリ ッ ジ を WonderSwan 背 面 の スロ ッ ト に 正しく 差し 込み ます 。 
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1.3.2 PC と WonderSwan の 接続 
1. スワ ン ケ ー ブ ル と クロ スケ ー ブ ル を 接続 し 、1 本 の 状態 に し まず クロ スケ ー ブ 
ル の コネ クタ は どちら を 使っ て も か まい ませ ん )。 
2. スワ ン ケ ー ブ ル の EXT コ ネ ク タ を WonderSwan の 周辺 機器 差し 込み 口 に し っ 
か り 差 し 込み ま ポ コー ド が 本 体 の 上 側 に 向かっ て 出る 方 向 )。 
3. PC の シリ アル ポー- ト ( RS232C DSUB-9) に クロ スケ ー ブ ル の コネ クタ を し っ か 
り 差 し 込み まず ざ シリ アル ボー- ト 番号 を 確認 し て お いて 下さ い )。 


1.3.3 WonderSwan 同 士 の 接続 
1. 対戦 通信 ケー ブル の コネ クタ を 片方 の WonderSwan の 周辺 機器 差し 込み 口 に 
し っ か り 差し 込み まず コー ド が 本 体 の 上 側 に 向かっ て 出る 方 向 )。 
2. 反対 側 の コネ クタ を 、 も う 一 方 の WonderSwan の 周辺 機器 差し 込み 口 に し っ か 
り 差 し 込み ます 。 
注意 : 対戦 通信 ケー ブル は 別売 


は じ め に お 読み くだ さい 


1.4 Magical CD-ROM に つい て 


Magical CD-ROM の 構成 は 次 の よう に な っ て いま す 。 


\ 


イン スト ー ル 用 自己 解凍 アー カイ ブ 較 
イン スト ー ル 用 zip ア ー カ イブ 図 
イン スト 一 ルフ ォ ル ダ 展 開 形 式 図 
ツー ル 、 コマ ンド 図 
16bit 版 ツー ル 、 コマ ンド 罰 
イン クル ー ド ファ イル 較 
ライ ブラ リ 、 ス ター ト ア ッ プ ルー チン 図 
LSI C-86 for WonderWitch 
| il | 拡張 用 イン ダイ レク トラ イブ ラリ 較 
バッ クア ッ プ OS バイ ナリ 
オン ライ ンマ ニュ アル 、 ド キュ メン ト 図 
サン プル プロ グラ ム 図 
ツー ルソー スプ ログ ラム 図 
コン トリ ビュ ーション 罰 


注意 : 同 梱 ツ ー ル に つい て は 、 各 ツ ー ル に 付属 の ド キュ メン ト を よく 読ん で お 使い くだ さい 。 


1.5 PC ぺ べ の イン スト ー ル 


WonderWitch の ご 使用 に あたっ て 、 まず 、 お 使い の PC へ の イン スト ー ル が 必要 で 
す 。 正 し く イ ンス トー ル が 行わ れ な いと 、 付属 の ツー ル や 同 梱 コ ン パ イラ な ど が 正常 に 
利用 で き な い 場合 が あり ます の で 、 以下 の 手順 を よく 読ん で 正しく イン スト ー ル し て くだ 
さい 。 


1.5.1 WWitch フォ ル ダ の イン スト 一 ル 

プロ グラ ム 開 発 に 必要 と な る ファ イル 群 は 、 WWitch フ ォ ル ダ に 格納 され ます 。 この 
フォ ル ダ を イン スト ー ル する に は 、 Magical CD-ROM に 収録 され て いる 自己 解凍 アー 
カイ ブ を 実行 し ます 。 自己 解凍 アー カイ ブ は 、 Magical CDROM の 一 番 上 の フォ ル ダ に 
“ WWitch.exe" と いう ファ イル 名 で 格納 され て いま す 。 エク スプ ロー ラ な ど で この ファ イ 
ル を 選択 し て 実行 する と 、 イン スト ー ラ 画面 が 表示 され ます 。 
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WonderWyitch 開 発 エッ トー- 「 ッ スト ・ 回 


Wonderwich 開 発 キ ッ ト イン スト ー ル 先 


Cr\wwitch 参照 (B)… | 
擬 小 ル (C) | 


WWitch フ ォ ル ダ の イン スト ー ル 先 を 指定 し [ OK] ボ タン を 押す と イン スト ー ル が 開 
始 さ れ ま す 。 

標準 的 な イン スト ー ル 先 ば '" C\WWitch" を 想定 し て いま す の で 、 それ 以 外 の 場所 
に イン スト ー ル する 場合 に は 、 付属 ツー ル 群 や 同 梱 コ ン パ イラ の 設定 を 変更 する 必要 
が あり ます 。 詳し く は 第 2 部 デベ ロッ パー ズ マ ニュ アル の 第 9 章 チュ ー ト リア ル 」 を 参 
照 し て くだ さい 。 

イン スト ー ル が 完了 する と 、 指定 し た フォ ル ダ の 中 に プロ グラ ム 開 発 に 必要 と な る フ 
ァイル 群 が 格納 され 、 イン スト ー ラ 画面 が 終了 し ます 。 

自己 解凍 アー カイ ブ が うま く 実行 で き な い 場合 に は 、 Magical CD-ROM か ら フ ォ ル 
ダ を コピ ー す る 方 法 で イン スト 一 ル を 行う こと も で きま す 。 この 場合 、 Magical CD- 
ROM の 一 番 上 の フォ ル ダ に WWitch と いう 名 前 の フォ ル ダ が 格納 され て いる の で 、 こ 
の フォ ル ダ を お 使い の PC に コピ ー し ます 。 


注意 : この 方 法 で は 、 フ ァイル の 属性 が リー ド オン リー に な っ て し まう こと が ある の で 、 通常 は 自己 解凍 アー カイ ブ 
に よる イン スト ー ル を 行っ て くだ さい 、。 


アン イン スト 一 ル を 行う 場合 は 、 イ ンス トー ル し た WWitch フ ォ ル ダ を 削除 し て くだ さい 。 


1.5.2 同 梱 ツ ー ル 群 の イン スト 一 ル 

必要 に 応じ て 、 Magical CD-ROM に 同 梱 され て いる ツー ル 群 を イン スト ー ル し ます 。 

Turbo C 20 の イン スト ー ル 手順 に つい て は 、J Magical CD-ROM 内 」 の Turbo 
C 20 英 語 版 イン スト ー ル 手順 ( \WWitch\doc\appendix\tcinstall\index. 
html) を 参照 し て くだ さい 。 

その 他 の ツー ル に つい て は 、 各 ツ ー ル に 付属 の ド キュ メン ト を 参照 し て くだ さい 。 


第 2 章 
基本 的 な 使い 方 


2.1 Meg 


ユー ザ と OS の 仲立 ち を する プロ グラ ム の こと を 一 般 に " シェル" と いい ます 。 OS は 
人 間 と 直接 や り 取 りす る こと が で きま せん 。 この た め 人 間 と の 仲立 ち を する ユー ザイ 
ンタ フェ ー ス プロ グラ ム で ある シェ ル が 必要 に な り ま す 。 シェ ル は ユー ザ の 指示 を OS に 
伝え 、OS か ら の メッ セー ジ を ユー ザ に 伝え ます 。 

WonderWitch の OS で ある FreyaOS」 で ば Meg」 と 呼ば れる シェ ル が デフ ォ ル ト 
の シェ ル デフ ォ ル トシ ェ ル ) に な っ て いま す 。 ユー ザ は Meg を 経由 し て 、 プロ グラ ム の 起 
動 、PC と の ファ イル 転送 、 WonderSwan 同 士 で の ファ イル 交換 な ど 、 さ ま ざ ま な 操作 
を 行い ます 。 

WonderWitch 専 用 カー トリ ッ ジ を セッ ト し て 、 電源 スイ ッ チ を ON に する と Meg が 自 
動 的 に 起動 し ます 。 


2.2 画面 と ボタ ン 


画面 に は 、 ラ ンチ ャ 画面 、 通信 画面 、 フ ァイル 画面 の 3 種類 が あり 、 必要 に 応じ て 画 
面 を 切り 替え て 使用 し ます 。 通常 は 使用 し な く て も よい 機能 や 使用 頻度 の 少な い 機 能 
は ポッ プア ッ プ メニ ュー に まとめ ら れ て いま す 。 


第 1 部 ユー ザー ズ マ ニュ アル 基本 的 な 使い 方 


2.2.1 ラン チャ 画面 ー プ ログ ラム の 起動 一 2.2.2 通信 画面 ファ イル の 転送 交換 一 
実行 可能 な プロ グラ ム フ ァ イル を 表示 し 、 選択 され た プロ グラ ム を 起動 する 画面 で PC と の 通信 、 WonderSwan 同 士 で の ファ イル 交換 を する 画面 で す 。 送信 受信 の 
す 。 両方 が 可能 で す 。 
強調 表示 ファ イル アイ コン 通信 方 向 表示 


( 変化 し ませ ん ) 


づ ロ ガラ ム エ リ 了 ワー ウエ リア 


| Engke 


I\ ス コア デー タ 


BSD 
に RneK さ 
ジン プロ グラ ム エ リ ア ワー クエ リア 
内 = pg 容量 ワ 穴 旦 
実行 可能 な ファ イル が な いと き に は ファ イル アイ コン は 表示 され ませ ん 。 空き 容量 空き 容量 
較 こ の 画面 で の メニ ュー 項目 固 こ の 画面 で の メニ ュー 項目 
ファ イル 情報 ファ イル 情報 
( サス ペン ド プロ セス 説明 ) 無 確認 送信 
オー プ ニ ン グ XM 受 信 
バー ジョ ン XM 送 信 
マン オヤ ラン チャ 
通信 通信 
ファ イル ファ イル 
ーー 時 停止 ーー 時 停止 
終了 終了 
注意 ここ で は 各 メ ニュ ー 項 目 の 説 明 は し ませ ん 注意 ここ で は 各 メ ニュ ー 項 目 の 説 明 は し ませ ん 。 


第 1 部 ユー ザー ズ マ ニュ アル 


2.2.3 ファ イル 画面 一 ファ イル の 整理 一 
ファ イル の 整理 を 行う 画面 で す 。 


づ ロ ザラ うふ エリ ア 了 


コピ ー 方 向 表示 


ウー ウエ リア 


還 こ の 画面 で の メニ ュー 項目 


* 削除 


ラン チャ 
通信 
ファ イル 


終了 


ファ イル 情報 


* ネ W せ いと ん 
*P せ いと ん 
ネ W 全 クリ ア 
* ネ P 全 クリ ア 


一 時 停止 


注意 ここ で は 各 メ ニュ ー 項 目 の 説明 は し ませ ん 


2.2.4 


ボタ ン 割 り 当て 


標準 の ボタ ン 割り 当て は 次 の よう に な っ て いま す 。 


決定 実行 

キャ ン セ ルプ メニ ュー 表示 
選択 

メニ ュー On/Off 

画面 切替 


基本 的 な 使い 方 


START: 一 時 停止 再開 
SOUND: 音量 調節 


注意 ボタン 割り 当て は 変更 する こと が で きま す 。 詳し くば 326 起動 時 の 設定 」 を 参照 。 本 書 で は 標準 の ボ 
タン 割り 当て に 従っ て 説明 し ます 。 

注意 ポッ プア ッ プ メニ ュー 中 の ' *※ "で 始ま る 項目 は ファ イル 削除 デー タ 破壊 の 危険 を 伴う 操作 の た め 、A ボ 
タン で 実行 する と 確認 ダイ アロ グ が 表示 され ます 。 これ ら の 項目 は STA RT ボタ ン で 実行 する こと も で きま 
す 。 この 場合 、 確認 ダイ アロ グ を 出さ ず に 即座 に 実行 し ます 。 


2.2.5 画面 切替 
Y2 ボ タン 、 ある い は Y 4 ボタ ン を 押す と 、 ラ ンチ ャ 画面 、 ファ イル 画面 、 通信 画面 が 順 


に 切り 替わり ます 。 メニ ュー か ら も 切替 可能 で す 。 


ーー に 2) C2J ヶ 
[和信 画面 鐘 <> | ラン チャ 画面 R<>| フ ァ ィ ル 画面 


2.2.60 ファ イル 

WonderWitch 専 用 カー トリ ッ ジ 上 の ファ イル は 以下 の 特性 を 持ち ます 。 ファ イル 名 の 
ほか に ファ イル の 説明 を 持た せる こと が で きま す 。 日 本 語 表 示 に は ShiftJIS コ ー ド が 使 
用 可能 で す 。 

ファ イル 名 16 バ 條 

"うお よび " "以外 の 文字 列 
た だ し 、 文字 列 中 に " /'、“ は 使用 不可 
説明 24 バ イト 
最大 サイ ズ 64K バ イト 


2.2.7 ファ イル アイ コン 

Meg で は ファ イル ば ファ イル アイ コン 」 で 表示 され ます 。 ファ イル アイ コン は 左側 の グ 
ラフ ィ ッ ク 部 分 と 、 右側 の テキ スト 部 分 か ら 構成 され ます 。 選択 され て いる ファ イル アイ 
コン は 強調 表示 され ます 。 グラ フィ ッ ク 部 分 は 次 の よう に ファ イル の 種類 ご と に 変化 し 
ます 。 
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ご) 実行 可能 な プロ グラ ム 
喘 イ ンダ イレ クト ライ ブラ ル IL) 
[| ] そ の 他 の ファ イル 


テキ スト 部 分 に は ファ イル の 説明 が 表示 され ます 。 


2.2.8 スク ロー ルイ ンジ ケー タ 

ファ イル の 数 が 多く な り 、 画面 上 に 一 度 に 表示 で き な い 場合 は 、 スク ロー ルイ ンジ ケ 
ー タ が 表示 され ます 。 

X ボ タン で スク ロー ルイ ンジ ケー タ の 示す 方向 に 移動 し て いく と 、 画面 が スク ロー ル 
し 、 隠れ て いた ファ イル アイ コン が 表示 され ます 。 


全 。 全 上 に まだ ファ イル アイ コン が ある 
軍 軍 下 に まだ ファ イル アイ コン が ある 


2.2.9 プロ セス イン ジ ケ ー タ 

WonderWitch で は FreyaOS で 実行 され て いる プロ グラ ム の こと を プロ セス 」 と 呼 
び ま す 。 プロ セス は 同時 に 2 つま で 切り 替え な が ら 実行 する こと が で きま プログ 
ラム が サス ペン ド ノリ ジュ ー ム 、 プロ セス 切替 に 対応 し て いる 必要 が あり ます )。 

Meg の 画面 左下 に 3 つ あ る 四角 は 、 現在 の 稼動 プロ セス を 示す プロ セス イン ジ ケ ー 
タ で す 。 四角 が 黒 に な っ て いる 場合 、 そ の プロ セス が 実行 中 また は サス ペン ド 中 で あ 
る こと を 示し ます 。 サス ペン ド 中 の プロ セス の こと を サス ペン ド プロ セス 」 と いい ます 。 


画 
Lossnai フ nk 


ユー ザ プ ロ セス は 同時 に は 1 つの み が 、 サス ペン ド で きる よう に な っ て いま す 。 この た 
め 、 2 つめ の ユー ザ プ ロ セス を サス ペン ド する こと は で きま せん 。 2 つめ の ユー ザ プ ロ 
セス で 、 そ の プロ セス が サス ペン ド 不可 な 場合 、LCD の ' ETC マー ク 小 "が 点灯 し 
まず すず 。 
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2.2.10 ファ イル エリ ア 
WonderWitch に は 、 2 つ ず ファ イル エリ ア ( ファ イル を 格納 する エリ ア ) が あり ます 。 
内 容 は 以下 に 示す 通り で す 。 


ファ イル エリ ア 名 容量 最大 ファ メモ リ 種類 主 な 用 途 
イル 個数 

プロ グラ ム エ リ ア 384KB 128 Flash Memory プロ グラ ム フ ァ 

イル の 格納 

ワー クエ リア 64KB 64 SRAM デー タフ ァ イ 

ル の 格納 


「 プロ グラ ム エ リ ア 」 は 主 に 、 プロ グラ ム フ ァ イル や イン ダイ レク トラ イブ ラリ な ど を 置く 
エリ ア で す 』 ワー クエ リア 」 は 主 に 、 セー ブ デ ー タ ファ イル や 一 時 ファ イル な ど を 置く エ 
リア で す 。 電源 を 切っ て も これ ら の 内 容 は 保持 され ます 。 


注意 ワー クエ リア に ある プロ グラ ム は 実行 で きま せん 。 


2.3 起動 と 終了 


起動 する に は WonderWitch 専 用 カー トリ ッ ジ を WonderSwan 本 体 に 正しく セッ ト し 
て 、 電源 スイ ッ チ を ON に し ます 。 この と き ボ タン の 押下 状態 に に っ て 、 い くつ か の 起動 
方 法 が 選択 で きま す 。 ここ で は 基本 的 な 起動 方 法 に つい て 説明 し ます 。 

電源 スイ ッ チ を OFF に する 前 に は 、 終了 」 ま た ば 一 時 停止 」 す る 必要 が あり ます 。 


注意 : 正しい 終了 手順 を 踏ま ず に 電源 を 切っ た 場合 や 不測 の 事態 が 発生 し た 場合 、 カー トリ ッ ジ 上 の ファ イル ま 
た は デー タ が 破壊 され る 可能 性 が あり ます 。 ファ イル や デー タ が 破壊 され た 場合 、 責任 を 負い か ね ます の 
で あら か じ め ご 了承 くだ さい 。 万 一 に 備え 、 重要 な ファ イル は パッ クア ッ プ を 取っ て お く よ う 心がけ て くだ さ 
い 。 


2.3.1 起動 
WonderWitch 専 用 カー トリ ッ ジ を WonderSwan に 正しく セッ ト し て 、 電源 スイ ッ チ を 


ON に し まず ボタ ン は 押さ な いで くだ さい )。 オー プ ニ ン グ が 表示 され た あと 、 Meg の 
ラン チャ 画面 が 表示 され ます 。 前 回 一 時 停止 し て いた 場合 は 再開 と な り 、 オ ー プ ニン 
グ は 表示 され ず に 一 時 停止 の 続き か ら 実行 され ます 。 
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注意 オー プ ニ ン グ 中 に A ボタ ン を 押す と 、 すぐ に ラン チャ 画面 に 切り 替わり ます 。 また 、 STA RT ボタ ン を 押す と 
スタ ッ フ ロー ル が 表示 され ます 。 


aeewien 


(E)2000 MutE Enrpnratinn [JEBHHDHI 純 


2.3.2 終了 

メニ ュー か ら 「 終了 」 を 実行 し ます 。 終了 画面 が 表示 され た ら 電源 スイ ッ チ を OFF 
に し ます 。 次 回 の 起動 は 通常 の 起動 と な り ま す 。 サス ペン ド プロ セス が ある 場合 、 保 
存 さ れ て いる サス ペン ド 情報 は 破棄 され ます 。 


注意 : 終了 画面 時 に Y 3 ボタ ン を 押す と 再起 動 し ます 。 
注意 サス ペン ド プロ セス が ある か どう か は 、 プロ セス イン ジ ケ ー タ で 確認 する こと が で きま す 。 


aeewien. 


スイ ッ 才 を 切っ て も @ に で す 


Y8ireboot 


2.3.3 一 時 停止 
Meg の 画面 で START ボタ ン を 押す と 現在 実行 中 の 状態 を 保存 し まず サス ペン 


ド )。 終了 画面 が 表示 され た ら 電源 スイ ッ チ を OFF に し ます 。 次 回 電源 スイ ッ チ を ON 
に し た 時 に は 、 保存 され た 状態 か ら 実行 を 再開 し ます 。 サス ペン ド プロ セス が ある 場 
合 、 サス ペン ド 情報 は 電源 スイ ッ チ を OFF に し て も 保持 され ます 。 
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注意 : 一 時 停止 画面 時 に START ボタ ン を 押す と 即座 に 再開 し 、 保存 され た 状態 か ら 再開 し ます 。 Y 3 ボタ ン を 
押す と サス ペン ド 情報 を 破棄 し て 再起 動 し ます 。 


aeewen 


スイ ッ 王 を 切っ て も 〇 に で す 


Y8: FeEO ロ nt』 = トコ ョ ビ t 上 : に じ ら ミ ロロ 


2.3.4 ユー ザ プ ロ グラ ム に よる 一 時 停止 
ユー ザ プ ロ グラ ム に よっ て は 、 独 自 の 一 時 停止 手順 を 採用 する も の が あり ます 。 こ 
の 場合 は ユー ザ プ ロ グラ ム の 指示 に し た が っ て 電源 スイ ッ チ を OFF に し ます 。 


2.4 カー トリ ッ ジ へ の 転送 


出荷 時 に は 、 WonderWitch 専 用 カー トリ ッ ジ に ユー ザ プ ロ グラ ム は 入っ て いま せん 。 
ユー ザ プ ロ グラ ム を 実行 する た め に は 、 あら か じ め プ ログ ラム ファ イル を カー トリ ッ ジ に 
転送 し て お く 必 要 が あり ます 。 

ファ イル 転送 に は 付属 の TransMagic」 を 使用 し ます 。 


注意 : TransMagic 以 外 に も Tera Term Pro な ど 、 XMODEM 機 能 を 備え た 通信 ソフ ト の 利用 が 可能 で す 。 
注意 : 接続 中 は Meg を 通信 画面 以外 に 切り 替え な いで くだ さい 。 
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較 フ ァイル 転送 の 流れ 2.4.2 準備 
- TransMagic を 使用 する た め に は 、 WonderSwan と PC を 接続 する 必要 が あり ます 。 
| ケー ブル 接続 較 
1. Swan ケー ブル と クロ スケ ー ブ ル を 接続 し 、 1 本 に し ます 。 クロ スケ ー ブ ル に は 向 


き の 指 定 が あり ませ ん の で 、 どちら の コネ クタ を 接続 し て も か まい ませ ん 。 

2. スワ ン ケ ー ブ ル の EXT コ ネ ク タ 側 を WonderSwan 本 体 の 周辺 機器 差し 込み 口 
に 接続 し ます 。 この と き WonderSwan の 電源 は 切っ て お きま す 。 

3. クロ スケ ー ブ ル 側 を PC の シリ アル ボー ト に 接続 し ます 。 この と き PC の 電源 は 切 


ファ イル 転送 ( n 回 ) 較 
っ て お きま す 。 シリ アル ポー ト は COM1 か ら COM4 ま で の いずれ で も か まい ませ 
ん 。 た だ し 、 別 の アプ リケーション や ド ライ バ が 占有 し て し まう ボー ト は 避け て く 


通信 終了 図 
だ さい 。 
4 デフ ォ ル ト 設定 は COMT を 使用 する よう に な っ て いる た め 、 COM 以 外 を 使用 す 


る 場合 に は TransMagic を 起動 し て [ ファ イル ] メ ニュ ー 革 シリ アル ボー ト 設 
定 ] で 使用 する COM ポ - ト を 選択 し [ OK] ボ タン を 押し て くだ さい 。 


通信 開始 較 


| 接続 中 婦 | 


ケー ブル 取り 外し 凶 


2.4.1 ファ イル 転送 ツー ル 一 TransMagic 一 2.4.3 TransMagic の 起動 
「 TransMagic( トラ ンス マジ ッ ク ) は Windows 上 で 動作 する ファ イル 転送 ツー ル で エク スプ ロー ラ な ど か ら \ WWitch\ bin\ TransMagic.exe を ダブ ルク リッ ク し て 起 
す 。 WonderWitch 専 用 カー トリ ッ ジ と 通信 し 、 ファ イル 転送 、 ファ イル 整理 、 時 刻 設定 、 動 し ます 。 
OS アッ プ グ レー ド な ど を PC か ら 簡単 に 行え ます 。 
ファ イル メニ ュー フォ ル ダ 指 定 エリ ア PC つ WonderSwan 転送 ボタ ン 2.4.4 TransMagic の 終了 


[ ファ イル ] メ ニュ ー 士 終了 ] を 選択 し ます 。 


5 2.4.5 通信 の 開始 
Moro/ 7 の ラム 4 エリ 7 。  ) 通信 に 先立ち 、TransMagic と WonderWitch 専 用 カー トリ ッ ジ を 接続 状態 に し ま 
oe g rp 2 ず 。。 ま た だ 、 WonderSwan 側 で Meg を 通信 画面 に し て お きま す 。 


200-05-18 0229:3(| 
2000-04-29 08H18:46| 
2000-05-23 08:391E| 


uint 19 95 1. TransMagic を 起動 し て 、 ピ ンク 色 の ステ ー タ スエ リア を クリ ッ ク す る か [ ファ イ 


回 makefile 2000-05-08 11:375E| 


回 samplefk L480 2000-05-29 103954 に ル ] メ ニュ ー 接続 ] を 実行 し ます 。 
ー 1 ッ ジ 側 ーー ヽ FN 人 台 ィ ー 、 ふ 1 ーー 
PC 側 フ ァイル リス ト ファ イル リス ト 2. ネゴシエーション の あと 接続 状態 に か なり 、 カー トリ ッ ジ の 内 容 が 表示 され ます 。 ス 


テー タス エリ ア は 緑色 に な り ま す 。 


Used available Capacity Entries 
4 山 100 に 


r 畑 - 半 | 押 L: 注意 ポート が オー プン で き な い 場 合 、 他 の アプ リケーション や ドラ イ バ と 競合 し て いな いか 確認 し て くだ さい 。 


拉 入 中 2.4.6 通信 の 終了 
PC 側 容量 カー トリ ッ ジ 側 容量 ステー タス 表示 


TransMagic と WonderWitch 専 用 カー トリ ッ ジ を 切断 状態 に 戻し ます 。 
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1. ステ ー タ スエ リア を クリ ッ ク す る か ファイル] メニュー 切断 ] を 実行 し ます 。 
2. COM ポ ー ト が クロ ー ズ され 、 切断 状態 に な り ま す 。 ステ ー タ スエ リア は ピン ク 色 
に 戻り ます 。 


注意 : ケー ブル の 取り 外し は 、 WonderSwan お よび PC の 電源 を 切っ て か ら 行っ て くだ さい 。 


2.4.7 時 刻 設 定 
WonderWitch 専 用 カー トリ ッ ジ に 内 蔵 さ れ た RT カレ ンダ ー ン 時 計 機 能 ) の 時 刻 
を 設定 し ます 。 


注意 : 出荷 時 に は 時 刻 は 設定 され て いま せん の で 、 最初 に 設定 し て お く 必 要 が あり ます 。 


1. TransMagic を 接続 状態 に し ます 。 

2.[ カー トリ ッ ジ ] メ ニュ ー 十 時 刻 設定 ] を 実行 し ます 。 

3.[ 設定 時 刻 ] フ ィ ー ル ド に 設定 し た い 時 刻 デフ ォ ル ト で は PC の 時 計 の 時 刻 ) を 
入力 OK] ボ タン を 押し ます 。 


2.4.8 ファ イル エリ ア の 選択 
WonderWitch 専 用 カー トリ ッ ジ 側 の 操作 対象 と な る ファ イル エリ ア を 選択 し ます 。 
ファ イル 転送 [ カー トリ ッ ジ ] メ ニュ ー の エリ ア 整 頓 ][ エリ ア 全 クリ ア ] は 選択 され 
て いる エリ ア に 対し て 行わ れ ま す 。 


1. TransMagic を 接続 状態 に し ます 。 

2. ファ イル エリ ア 選択 ド ロップ ダウ ン リ スト か ら 、 /fom07 プロ グラ ム エ リ ア ) "また 
ば "am0% ワー クエ リア ) "を 選択 し ます 。 

3. 選択 され た エリ ア の 状態 が ファ イル リス ト に 表示 され ます 。 


2.4.9 PC か ら の ファ イル 転送 PC つっ WonderSwan) 
PC 上 の ファ イル を WonderWitch 専 用 カー トリ ッ ジ 上 に 転送 し ます 。 


1. TransMagic を 接続 状態 に し ます 。 

2.[ WonderWitch カ ー ト リッ ジ 」] 領 域 に 表示 され て いる ファ イル エリ ア を 選択 し ま 
ボ ポ プロ グラ ム を 転送 する と き ば "/rom07 プロ グラ ム エ リ ア )” を 選択 し ます )。 

3. フォ ル ダ 指定 エリ ア で 転送 し た い フ ァイル の ある フォ ル ダ を 指定 し ます 。 

4. 転送 し た い フ ァイル を 選択 し ] ボ タン を クリ ッ ク し ます 。 
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5. WonderWitch 転 送 形 式 で な い フ ァイル の 場合 、 WonderWitch 転 送 形式 に 変換 
する た め の ダ イア ログ が 表示 され ます の で 、 必要 な 情報 を 正しく 設定 し て くだ さ 
い 。 

6. 実際 に ファ イル を 転送 し ます 。 転送 中 は 電源 を 切ら な いよ うに 注意 し て くだ さい 。 

. 転送 が 終了 する と ファ イル エリ ア が 更新 され ます 。 


| 


弄 


注意 : 受信 中 に 電源 を 切る と 、 デ ー タ が 破壊 され ます の で 注意 し て くだ さい 。 
注意 : 送信 受信 中 に 中 断 す る と 、 ゴミ ファ イル が 生成 され る こと が あり ます 。 ゴミ ファ イル は 削除 され た ファ イル 
と 同じ も の で す 。 エリ ア 整頓 され る まで は ゴミ ファ イル の サイ ズ 分 だ け 空 き 容量 が 減り ます 。 


2.4.10 WonderSwan か ら の ファ イル 転送 


( WonderSwan つ PC) 
WonderWitch 専 用 カー トリ ッ ジ 上 の ファ イル を PC に 転送 し ます 。 


. TransMagic を 接続 状態 に し ます 。 

. ファ イル エリ ア 選択 ド ロップ ダウ ン リ スト で ファ イル エリ ア を 選択 し ます 。 

フォ ル ダ 指定 エリ ア で 転送 先 の フォ ル ダ を 指定 し ます 。 

. 転送 し た い フ ァイル を 選択 し て] ボタ ン を クリ ッ ク し ます 。 

. 実際 に ファ イル を 転送 し ます 。 転送 中 は 電源 を 切ら な いよ うに 注意 し て くだ さい 。 
転送 され る ファ イル は WonderWitch 転 送 形式 と な り ま す 。PC に 作成 され る ファ 
イル 名 は 、 WonderWitch 上 の ファ イル 名 に .fx” の 拡張 子 が 付加 され た も の と 
な り ま す 。 

6. 転送 が 終了 する と ファ イル エリ ア が 更新 され ます 。 


の m ロ ト の DO ーー 


2.5 プロ グラ ム の 実行 と ファ イル 操作 


この 節 で は Meg を 使っ た プロ グラ ム の 実行 や ファ イル 整理 な どの 操作 方 法 を 説明 
し ます 。 


還 生 表記 の 意味 
[ ラン チャ ] ラン チャ 画面 で 操作 可能 で す 。 
[ 通信 ] 。 通信 画面 で 操作 可能 で す 。 


[ ファ イル ] ファ イル 画面 で 操作 可能 で す 。 


19 


第 1 部 ユー ザー ズ マ ニュ アル 基本 的 な 使い 方 


2.5.1 プロ グラ ム の 実行 2.5.5 サス ペン ドブ プロ セス の リ ジ ュ ー ム 
[ ラン チャ ] [ ラン チャ ] 
1. Meg を ラン チャ 画面 に し ます 。 1. Meg を ラン チャ 画面 に し ます 。 
2. X ボ タン で 起動 し た い プ ログ ラム を 選択 し ます 。 2. メニ ュー を 表示 し ます 。 
3. A ボ タン で 起動 し ます 。 3. サス ペン ド プロ セス が ある 場合 、 メニ ュー 項目 に サス ペン ド プロ セス の 説明 が 
表示 され て いる の で 、 こ れ を 選択 し ます 。 
2.5.2 ファ イル 情報 の 表示 4. A ボ タン で 実行 し ます 。 
[ ラン チャ 1 通信 1 ファ イル ] 5. サス ペン ド し て いた プロ セス が リ ジ ュ ー ム し ます 。 
1. Meg で ファ イル を 選択 し ます 。 注意 , サス ペン ド プロ セス が な い 場合 、 メニュー 項目 に ば ' ( None) "と 表示 され ます 。 
2. メニ ュー を 表示 し ます 。 
3. X ボ タン で < ファ イル 情報 を 選択 し ます 。 2.5.6 ファ イル の エリ ア 間 コピ ー 
4. A ボ タン で 実行 し ます 。 [ ファ イル ] 


5. ファ イル 情報 が 表示 され まず いずれ か の ボタ ン を 押す と 消え ます )。 
1. Meg を ファ イル 画面 に し ます 。 
2.5.3 オー プ ニ ン グ の 表示 2. X ボ タン で コピ ー し た い フ ァイル を 選択 し ます 。 
[ ラン チャ ] 3. A ボ タン で 実行 し ます 。 
4. ファ イル が 別 エ リア に コピ ー さ れ ま す 。 


1. Meg を ラン チャ 画面 に し ます 。 
2. メニ ュー を 表示 し ます 。 注意 : コピ ー 先 に 同一 ファ イル 名 の ファ イル が ある 場合 は コピ ー さ れ ま せん 。 
3. X ボ タン で ご オープニング > を 選択 し ます 。 注意 : コピ ー 中 に 電源 を 切る と ファ イル エリ ア の デー タ が 破壊 され ます の で 注意 し て くだ さい 。 
4. A ボ タン で 実行 し ます 。 
5. オー プ ニ ン グ が 表示 され まず オー プ ニ ン グ 中 に START ボタ ン を 押す と スタ 2.5.7 ファ イル の 削除 
ッ フ ロー ル が 表示 され ます 。 それ 以外 の ボタ ン を 押す と ラン チャ 画面 に 戻り ま [ ファ イル ] 
す )。 
1. Meg を ファ イル 画面 に し ます 。 
2.5.4 バー ジョ ン 情 報 の 表示 2. X ボ タン で 削除 し た い フ ァイル を 選択 し ます 。 
[ ラン チャ ] 3. メニ ュー を 表示 し ます 。 
4. メニ ュー か ら ぐ *※ フ ァイル 削除 > を 選択 し ます 。 
1. Meg を ラン チャ 画面 に し ます 。 5. A ボ タン で 実行 し まず 確認 せ ず に 即座 に 削除 する 場合 は START ボ タン を 押し 
2. メニ ュー を 表示 し ます 。 ます )。 
3. X ボ タン で て バージョン ジジ を 選択 し ます 。 6. A ボ タン を 押し た 場合 、 確認 ダイ アロ グ が 表示 され る の で 、 A で 実行 、 ま た は B 
4. A ボ タン で 実行 し ます 。 で キャ ン セ ル し ます 。 
5. バー ジョ ン 情報 が 表示 され まず 何 か ボ タン を 押す と 消え ます )。 7. ファ イル が 削除 され ます 。 
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注意 ファ イル を 削除 し て も 空き 容量 は 増え ませ ん 。 空き 容量 を 増やす た め に は エリ ア 整頓 を 行う 必要 が あり ます 。 
注意 : 削除 中 に 電源 を 切る と ファ イル エリ ア の デー タ が 破壊 され ます の で 注意 し て くだ さい 。 


2.5.8 エリ ア 整 頓 
[ ファ イル ] 

エリ ア 整頓 は 、 削除 され た ファ イル が 使っ て いた 部 分 を 回 収 し 、 エリ ア の 空き 容量 
を 増やし ます 。 前 回 の 整頓 より あと に 、 削除 され た ファ イル や 転送 中 断 に よる ゴミ ファ 
イル が な い 場合 に は 容量 は 増え ませ ん 。 


ーー 


. Meg を ファ イル 画面 に し ます 。 

メニ ュー を 表示 し ます 。 どの ファ イル が 選択 され て いて も か まい ませ ん 。 

整頓 し た い エ リア に あわ せ て 、 メニ ュー か ら ご * W せ いと ん ワー クエ リア の 整 

頓 )、 ま た は <* P せ いと ん プロ グラ ム エ リ ア の 整頓 ) を 選択 し ます 。 

4. A ボ タン で 実行 し まず 確認 な し で 即座 に エリ ア 整頓 する 場合 は START ボ タン 
を 押し ます )。 

5. A ボ タン を 押し た 場合 、 確認 ダイ アロ グ が 表示 され る の で 、 A ボ タン で 実行 、 ま 
た は B ボ タン で キャ ン セ ル し ます 。 

6. エリ ア が 整頓 され 、 空き 容量 が 増え ます 。 


oO_ DD 


注意 , サス ペン ド プロ セス が ある 場合 エリ ア 整頓 は で きま せん 。 サス ペン ド プロ セス を 終了 し て か ら 実行 し くだ 
さい 。 


注意 : 整頓 中 に 電源 を 切る と エリ ア の デー タ が 破壊 され ます の で 注意 し て くだ さい 。 


Z.5.9 エリ ア 全 クリ ア 
[ ファ イル ] 

エリ ア 全 ク リア は 、 選択 され た ファ イル エリ ア を 初期 化し ます 。 すべ て の ファ イル は 削 
除 さ れ 、 空き 容量 も 最大 に な り ま す 。 


1. Meg を ファ イル 画面 に し ます 。 

2. メニ ュー を 表示 し ます 。 どの ファ イル が 選択 され て いて も か まい ませ ん 。 

3. 全 ク リア し た い エ リア に あわ せ て 、 メニ ュー か ら マ ご * W 全 クリ アズ ワー クエ リア 
の 全 ク リア )、 また は <* P 全 クリ ア プロ グラ ム エ リ ア の 全 ク リア ) を 選択 し ま 
す 。 

4. A ボ タン で 実行 し まず ( 確認 な し で 即座 に エリ ア 全 ク リア する 場合 は START ボ 
タン を 押し ます )。 
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5. A ボ タン を 押し た 場合 、 確認 ダイ アロ グ が 表示 され る の で 、 A ボ タン で 実行 、 ま 
た は B ボ タン で キャ ン セ ル し ます 。 
6. エリ ア が 全 ク リア され 、 空 き 容 量 が 増え ます 。 


注意 : 必要 な ファ イル は パッ クア ッ プ を 取っ て お きま し ょ う 。 
注意 : エリ ア 全 ク リア 中 に 電源 を 切る と エリ ア の デー タ が 破壊 され ます の で 注意 し て くだ さい 。 


2.6 WonderSwan 同士 で の ファ イル 交換 


別売 の 対戦 通信 ケー ブル を 使用 する こと で 、 WonderSwan 同 士 で 直接 ファ イル 交 
換 す る こと が で きま す 。 


温 


ファ イル 交換 で は 送信 側 と 受信 側 の 区 別 は な く 、 通信 画面 に する だ け で 送信 、 
信 の 両方 が で きる よう に な っ て いま す 。 


. WonderSwan 同士 を 対戦 通信 ケー ブル で 接続 し て お きま す 。 

. 2 台 と も Meg を 通信 画面 に し ます 。 

. 送信 する 側 で 転送 し た い フ ァイル を 選択 し ます 。 

. 送信 する 側が A ボ タン を 押し ます 。 

。 受信 側 に 受け 取る か どう か の 確認 ダイ アロ グ が 出 ま す 。 

. 受信 側が 受け 取り を ' OK" し た 場合 、 フ ァイル 転送 が 始ま り ます 。 
. 送信 側 と 同じ ファ イル エリ ア に ファ イル が 受信 され ます 。 


っ の 愉 OPDO 一 
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第 3 章 
高度 な 使い 方 


3.1 高度 な 使い 方 に つい て 


本 章 で 紹介 する 操作 、 機能 は 、 通常 は 使わ な く て も よい も の も 含ま れ て いま す 。 用 
語 や 意味 が わか ら な い 場 合 に は 使用 し な いこ と を お すす めし ます 。 


3.2 Meg 


基本 的 な 使い 方 で は 触れ られ な か っ た 使い 方 を 説明 し ます 。 


3.2.1 無 確認 送信 
[ 通信 ] 
WonderSwan 同士 の 交換 で 、 受信 側 の 確認 ダイ 1 アロ グ を 表示 せ ず に 送信 し ます 。 


. WonderSwan 同 士 を 通信 対戦 ケー ブル で 接続 し ます 。 
両方 の WonderSwan の Meg を 通信 画面 に し ます 。 

. 送信 する 側 で メニ ュー を 表示 し ます 。 

- X ボ タン で べく 無 確認 送信 > を 選択 し ます 。 

. A ボ タン で 実行 し ます 。 

- ファ イル が 転送 され ます 。 


の um ト ODN 一 


注意 受信 中 に 電源 を 切る と 、 デ ー タ が 破壊 され ます の で 注意 し て くだ さい 
注意 : 送信 受信 中 に 中 断 す る と 、 ゴミ ファ イル が 生成 され る こと が あり ます 。 ゴミ ファ イル は 削除 され た ファ イル 
と 同じ も の で す 。 エリ ア 整 頓 さ れる まで は ゴミ ファ イル の サイ ズ だ け 空 き 容量 が 減り ます 。 
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3.2.2 XMODEM 受 信 
[ 通信 ] 

XMODEM を 使用 し て 、 WonderWitch 転 送 形式 の ファ イル を 受信 し ます 。 Trans 
Magic を 使わ ず 、 好み の XMODEM ツ ー ル で 直接 ファ イル 転送 する と き に 使用 し ます 。 


PC - WonderSwan 接続 ケー ブル で PC と WonderSwan を 接続 し ます 。 

. Meg を 通信 画面 に し ます 。 

WonderWitch 転 送 形 式 の ファ イル を 、 好み の XMODEM ツ ー ル で 送信 し ます 。 
メニ ュー を 表示 し ます 。 

. X ボ タン で て XM 受 信 > を 選択 し ます 。 

. A ボ タン で 実行 し ます 。 

- ファ イル が 転送 され ます 。 


ざい の の ロト ON ーー 


3.2.3 XMODEM 送 信 
[ 通信 ] 

カー トリ ッ ジ 上 の ファ イル を 、 WonderWitch 転 送 形 式 に し て 、 XMODEM で ファ イル 
を 送信 し ます 。 TransMagic を 使わ ず 、 好み の XMODEM ツ ー ル で 直接 ファ イル 転送 
する と き に 使用 し ます 。 


PC - WonderSwan 接 続 ケ ー ブ ル で PC と WonderSwan を 接続 し ます 。 
Meg を 通信 画面 に し ます 。 

送信 する ファ イル を 選択 し ます 。 

メニ ュー を 表示 し ます 。 

. X ボ タン で ぐ XM 送 信 と を 選択 し ます 。 

. A ボ タン で 実行 し ます 。 

. PC 側 の 好み の XMODEM ツ ー ル で 受信 し ます 。 

- ファ イル が 転送 され ます 。 


oo の mn R の oN コー 


3.2.4 リモ ー ト シェ ル 
[ 通信 ] 
通信 画面 で は シリ アル ポー ト を 経由 し て Meg を 操作 で きま す 。 この よう に PC か ら 操 
作 す る た め の イ ンタ フェ ー ス を WonderWitch で ば " リモ ー ト シェ ル ”" と 呼び ます 。 リモ ー 
トシ ェ ル で 利用 可能 な コマ ンド と その 書式 に つい て は J 付録 D.1 リモ ー ト シェ ルプ ロ 
トコ ル 仕 様 書 」 を 参照 し て くだ さい 。 


25 


第 1 部 ユー ザー ズ マ ニュ アル 


較 主 な コマ ンド 


ls df put get delete exec HELO stby reboot newfs defrag rename copy 
speed date setinfo chmod cd pwd 


リモ ー ト シェ ル を 使用 する た め に は PC 側 で Tera Term Pro な どの ター ミナ ル ソ フ 
ト を 立ち 上 げ て お く 必 要 が あり ます TransMagic と の シリ アル ポー ト の 競合 に 注意 
し て くだ さい )。 

ター ミナ ル ソ フ ト の 設定 は 次 の よう に し ます 。 


speed|: 38400bps 
data: 8bit 
parity: none 

stop bit: 1 


flow control: none 

newr-line: send CR /recv CR 
kanji code: ShifUIS 
localecho: off 


通信 画面 に 切り 替え た 直後 は プロ ンプ ト は 表示 され ませ ん ( ノン イン タラ クティ ブ モ ー 
ド )。 改行 の み の 行 を お くる が "stty echo" コ マン ド を 発行 する こと で プロ ンプ ト が 表 
示さ れ ま ず イン タラ クティ ブ モ ー ド )。 

プロ ンプ ト に 続い て コマ ンド を 入力 し て くだ さい 。 


3.2.5 シン プル モー ド 起動 

シン プル モー ド は 主 に 問題 が 発生 し た 場合 の 復旧 時 に 使用 し ます 。 シン プル モー ド 
で 起動 し た 場合 は 、 初期 設定 ファ イル の 読み 込み 、 ユ ー ザ シェ ル へ の 切り 替え 、 サス 
ペン ド デー タ に よる 再開 は 行わ れ ま せん 。 

シン プル モー ド で 起動 する 場合 に は Y 1 ボタ ン 、 Y 4 ボタ ン を 同時 に 押し な が ら 電源 
スイ ッ チ を ON に し ます 。 


3.2.6 起動 時 の 設定 

初期 設定 ファ イル を "init.rc" と いう ファ イル 名 で プロ グラ ム エ リ ア に 置く と 、 起動 時 に 
その 内 容 が 読み 込ま れ ま す 。 

Meg に 関係 し た 設定 と し て 、 次 の 環境 定数 が 定義 で きま す 。 
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SMEG_KEYBIND= ご キー マッ プ 番 号 ボタ ン 割 り 当て の 変更 
SMEG_AUTORUN= ぐ exec パラ メー タン 自動 実行 プロ グラ ム の 指定 


書式 は 次 の 通り で す 。 


$ 環 境 定数 名 値 べ 改行 > 


注意 " =” の 前 後に 空白 が あっ て は いけ ませ ん 。 
注意 : 初期 設定 ファ イル の 詳細 に つい て は 、 デベ ロッ パー ズ マ ニュ アル の ソフ トウ ェ ア ア ー キ テク チャ 」 を 参照 し 
て で くだ さい 。 


固 SMEG_KEYBIND: ボタ ン 割 り 当て の 変更 


・SMEG_KEYBIND=0 


決定 実行 
B: キャ ン セ ルプ メニ ューON/OFF 
XX 選択 
Y1、 き メニ ューON/OFF 
Y2 画面 切り 替え 右 回 り ) 
Y4 画面 切り 替え ( 左 回 り ) 


START: 一 時 停止 再開 
SOUND: 音量 調節 


・SMEG_KEYBIND= 1 


A: 決定 実行 

B: キャ ン セ ル ノ 画 面 切り 替 左 回 り ) 
X% 選択 

Y1、2、3: メニ ュー ONOFF 

START: ー 時 停止 再開 


SOUND: 音量 調節 


・SMEG_KEYBIND= 2 
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A: 決定 実行 
B: キャ ン セ ルプ メニ ューON/OFF 
X% 選択 


Y2、3: 画面 切り 替 右 回 り ) 
Y1、 4 画面 切り 替え 左 回 り ) 
START: ー 時 停止 再開 
SOUND: 音量 調節 


・SMEG_KEYBIND= 3 


A: 決定 実行 

B: キャ ン セ ルプ メニ ューON/OFF 
多 選択 

Y1、S メニ ューON プ 選択 

Y2 画面 切り 替え 右 回 り ) 

Y4 画面 切り 替え 左 回 り ) 
START: ー 時 停止 再開 


SOUND: 音量 調節 


固 SMEG_AUTORUN: 自動 実行 プロ グラ ム の 指定 


例 : 起動 時 に イメ ー ジ ファ イル を 20 単位 時 間 だ け 表 示し ます 。 


SMEG_AUTORUN= /rom0/imager imagefile 20 


3.3 TransMagic 


基本 的 な 使い 方 で は 触れ られ な か っ た 使い 方 を 説明 し ます 。 


3.3.1 カー トリ ッ ジ 情報 の 表示 


WonderWitch 専 用 カー トリ ッ ジ に 関す る 情報 を 表示 し ます 。 


1. TransMagic を 接続 状態 に し ます 。 


21 カー トリ ッ ジ メニ ュー 寺 カー トリ ッ ジ 情報 ] を 選択 し ます 。 
3. カー トリ ッ ジ 情報 が 表示 され まず [ OK] ボ タン を クリ ッ ク す る と 消え ます )。 
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3.3.2 エリ ア 整 頓 
選択 し て いる ファ イル エリ ア の 整頓 を 行い ます 。 


1. TransMagic を 接続 状態 に し ます 。 

2. 整頓 し た い フ ァイル エリ ア を 選択 し ます 。 

3[ カー リッジ ] メ ニュ ー 十 エリ ア 整頓 ] を 選択 し ます 。 
4. エリ ア 整頓 が 行わ れ ま す 。 


3.3.3 エリ ア 全 クリ ア 
選択 し て いる ファ イル エリ ア の 初期 化 を 行い ます 。 


1. TransMagic を 接続 状態 に し ます 。 

2. 全 ク リア し た い フ ァイル エリ ア を 選択 し ます 。 

3[ カー トリ ッ ジ ] メ ニュ ー 十 エリ ア 全 ク リア ] を 選択 し ます 。 
4. エリ ア 全 ク リア が 行わ れ ま す 。 


3.3.4 シリ アル ポー ト の 設定 
PC の シリ アル ポー ト の 設定 を 行い まず WonderSwan 側 の 設定 は 行わ れ ま せん )。 


1. TransMagic を 非 接続 状態 に し ます 。 

2[ ファ イル ] メ ニュ ー 士 シリ アル ボー ト 設定 ] を 選択 し ます 。 

3.[ 通信 設定 ] ダ イア ログ で 、 使用 する 通信 ポー ト 、 通信 速度 を リス ト か ら 選 択 し 
ます 。 

4| OK] ボ タン を クリ ッ ク す る と 設定 され ます 。 


3.3.5 プロ トコ ル ロ グ の クリ ア 
WonderSwan と の プロ トコ ル ロ バ 通信 内 容 の 記録 ) を クリ ア し ます 。 


1[ ファ イル ] メ ニュ ー 十 プロ トコ ル ロ グ の クリ ア ] を 選択 し ます 。 
2. プロ トコ ル ロ グ の 表示 エリ ア が クリ ア さ れ ま す 。 


3.3.6 プロ トコ ル ロ グ の 保存 
プロ トコ ル ロ グ に ファ イル 名 を つけ て 保存 し ます 。 


1[ ファ イル ] メ ニュ ー 陳 プロ トコ ル ロ グ の 保存 ] を 選択 し ます 。 
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2 名 前 を 付け て 保存 ] ダ イア ログ が 表示 され ます 。 
3. 任意 の ファ イル 名 を 入力 し て OK] ボ タン を クリ ッ ク し ます 。 


3.4。 毛 三 夕 モ 一 ド 
OS の アッ プ グ レー ド パッ クア ッ プ 時 、 カ ー ト リッ ジ 情 報 設 定時 に 使用 し ます 。 
3.4.1 モニ タモ ー ド 起動 


1. B ボ タン を 押し な が ら 電源 スイ ッ チ を ON に し ます 。 
2. モニ タモ ー ド に 入り ます 。 


注意 A ポ タン と B ボ タン を 同時 に 押し な が ら 電源 スイ ッ チ を ON に し た 場合 、VT 100 エ スケ ー プ シー ケン ス を 合 
し て シリ アル ポー ト に も モニ タモ ー ド 画面 を 出力 し ます 。 これ に より 、 PC の キー ボー ド を 使用 し て の 操作 
が 可能 で す 。 


3. 交 2 。 年 三 ダ モー ドル メ 三 ョ ー 


モニ タモ ー ド で は 、 OS の アッ プ グ レー ド 、 時 刻 設定 、 シ リア ルポ ー ト 速度 お よび スリ 
ー プ 時 間 の 設定 が で きま す 。 


田 モ ニタ モー ド の メニ ュー 


Setup カー トリ ッ ジ セッ ト アッ プ メ ニュ ー の 表示 
Recv System OS の アッ プ グ レー ド 

Send System OS の バッ クア ッ プ 

Recv Soft 使用 し ませ ん 

Send Soft 使用 し ませ ん 


Exit モニ タモ ー ド の 終了 
圏 Setub メ ニュ ー 

Date 日 付 

Time 時 間 


Baudrate シリ アル ポー ト 速度 
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Sleep LCD ス リー プ ま で の 時 間 


3.5 ユー ザ シ ェ ル の 利用 


FreyaOS は プロ グラ ム エ リ ア /rom0) に '@shell" と いう 名 前 の ファ イル が ある と 、 こ 
れ を ユー ザ 指 定 の シェ ル 「 ユー ザ シ ェ ル 」) と し て 使用 し ます 。 た だ し 、 こ の ファ イル は 
RunnablelL の イン ダイ レク トラ イブ ラリ で ある 必要 が あり ます 。 

この 機構 に に っ て 、 ユー ザ は 好み の シェ ル を 使用 する こと が で き 、 開発 者 は 好み の 
シェ ル を 提供 する こと が で きま す 。 

ユー ザ シ ェ ル を 指定 し た 場合 で も 、 Y 1 ボタ ン と Y 4 ボタ ン を 同時 に 押し て 起動 する こ 
と で デフ ォ ル ト の シェ ル Meg) が 起動 し ます 。 ユー ザ シ ェ ル を 削除 する 場合 は 、 デ フォ 
ルト シェ ル を 起動 し た 後 、 プロ グラ ム エ リ ア の ' @shell" フ ァイル を 削除 し て くだ さい 。 
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第 4 章 
OS の アッ プ グ レー ド 


4.1 OS の アッ プ グ レー ド の 前 に 


OS を アッ プ グ レー ド する 際 に は 、 サポ ー ト Web サ イト http://wonderwitch.qute.co. 


jp/) から 、 最新 版 OS を 入手 し ます 。 ダウ ン ロ ー ド し た ファ イル に 含ま れる ド キュ メン ト を 
よく 読ん で くだ さい 。 


注意 : アッ プ グ レー ド 後 の 最初 の 起動 で TEST." や " <Initializing File System> "と 表示 され る こと が あり ます 。 
これ は 自己 診断 プロ グラ ム 実 行 中 お よび メモ リ 初期 化 中 を 示す メッ セー ジ で す の で 、 電源 を 切ら ず に その 
まま お 待ち くだ さい 。 し ば らく する と 通常 の オー プ ニ ン グ 画面 に な り ま す 。 


4.2 現在 の OS の バッ クア ッ プ 


OS を アッ プ グ レー ド する 際 に は 、 必ず 現在 の OS の パッ クア ッ プ を 取っ て お く よ う に 心 
が け て くだ さい 。 パク アッ プ の 方 法 に は 、 次 の 2 つの 方 法 が あり ます 。 


4.2.1 TransMagic で の バックアップ 


1. PC - WonderSwan 接 続 ケ ー ブ ル で PC と WonderSwan を 接続 し ます 。 

2. モニ タモ ー ド で 起動 し まず B ボ タン を 押し な が ら 電源 スイ ッ チ ON)。 

3. TransMagic を 起動 し ます 。 

4. 切断 状態 に な か な っ て いる こと を 確認 し ます 。 

5.[ カー トリ ッ ジ ] 士 FreyaOS] 士 バッ クア ッ プ ] と メニ ュー を 選択 し ます 。 

6. バッ クア ッ プ ファ イル の 名 前 を 入力 OK] ボ タン を クリ ッ ク し まず ファ イル 名 


32 


OS の アッ プ グ レー ド 


に バー ジョ ン 番号 を 含め て お く と よい で し ょ う )。 
7. TransMagic が 受信 状態 に な か る の で 、 モニ タモ ー ド メニ ュー か ど ぢ ど " Send System" 


を 実行 し ます 。 
8. OS が WonderSwan か ら PC へ 転送 され まず 転送 開始 まで 少し 時 間 が か か る 場 
合 が あり ます )。 
9. モニ タモ ー ド メニ ュー か どら "Exit” を 選択 し て モニ タモ ー ド を 終了 し ます 。 
= 回 | 
アイ ル ⑥ | カー AM プ ⑪ 
マイ 1 り 7 聞 の WenderWitch カー トリ ッ ジ 
IEWWwicf エリ ア 全 の 7(@ 民 | し っ 3 [cnn/ ヴ ロ グラ ム エ リ ア ) 回 | 
[ 到 凍 MAGEC) に lg サイ ズ 年 
ロ か 2 人 報 - で ) ト ne-2g 14285e 
人 2 
国 calsndarf 1862 2000FUE-TBT4U94L > 
国 calendsrmap 1542 2000-06-18 14094C | 半 | 
同 maketie 242 2000-05-08 20375E 
<< 
1 上衣 2| ll | 過 | 
プロ トコ ル ロ テ 
イト 鞭 き 容量 55467WYfH Hf 中 タ 


4.2.2 好み の XMODEM ツ ー ル で の バッ クア ッ プ 


1. PC - WonderSwan 接 続 ケ ー ブ ル で PC と WonderSwan を 接続 し ます 。 

2. モニ タモ ー ド で 起動 し まず B ボ タン を 押し な がら 電源 スイ ッ チ ON)。 

3. XMODEM ツ ー ル で XMODEM 受 信 を 開始 し ます 。 

4. XMODEM ツ ー ル が 受信 状態 に か っ た ら 、 モ ニタ モー ド メニ ュー か ら “ Send 
System” を 実行 し ます 。 

. OS が WonderSwan か ら PC へ 転送 され まず 転送 開始 まで 少し 時 間 が か か る 場 
合 が あり ます )。 

6. モニ タモ ー ド メニ ュー か どら" Exit” を 選択 し て モニ タモ ー ド を 終了 し ます 。 


O1 


4.3 新しい OS へ の アッ プ グ レー ド 
新しい OS に アッ プ グ レー ド する に は 、 次 の 2 つの 方 法 が あり ます 。 いずれ の 場合 も 、 


アッ プ グ レー ド 操作 を する 前 に 、 最新 版 OS の パッ ケー ジ を 展開 し て 、 最新 OS の バイ ナ 
リフ ァイル の 名 前 を 確認 し て お きま す 。 
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4.3.1 TransMagic で の アッ プ グ レー ド 


. PC - WonderSwan 接 続 ケ ー ブ ル で PC と WonderSwan を 接続 し ます 。 

. モニ タモ ー ド で 起動 し まず B ボ タン を 押し な が ら 電源 スイ ッ チ ON)。 

. TransMagic を 起動 し ます 。 

. 切断 状態 に な か っ て いる こと を 確認 し ます 。 

.[ カー トリ ッ ジ ] 士 FreyaOS] 士 アッ プ グ レー ド ] と メニ ュー を 選択 し ます 。 

6. 最新 OS の バイ ナリ ファ イル の 名 前 を 正しく 入力 また は 選択 し [ OK] ボ タン を ク 
リッ ク し ます 。 

7. TransMagic が 送信 状態 に か る の で 、 モニ タモ ー ド メニ ュー か ど ぢ ど " Recv System" 
を 実行 し ます 。 

8. OS が PC か ら WonderSwan へ 転送 され まず 転送 開始 まで 少し 時 間 が か か る 場 
合 が あり ます )。 

9. モニ タモ ー ド メニ ュー か ど " Exit”" を 選択 し て モニ タモ ー ド を 終了 し ます 。 


OO R O DD 一 


4.3.2 好み の XMODEM ツ ー ル で の アッ プ グ レー ド 


. PC - WonderSwan 接 続 ケ ー ブ ル で PC と WonderSwan 接 続 し ます 。 

. モニ タモ ー ド で 起動 し まず B ボ タン を 押し な が ら 電源 スイ ッ チ ON)。 

- XMODEM ツ ー ル で 、 最新 OS の バイ ナリ ファ イル を XMODEM 送 信 し ます 。 

. XMODEM ツ ー ル が 送信 状態 に か っ た ら 、 モ ニタ モー ド メニ ュー か ら " Recv 
System” を 実行 し ます 。 

5. OS が PC か ら WonderSwan へ 転送 され まず 転送 開始 まで 少し 時 間 が か か る 場 

合 が あり ます )。 
6. モニ タモ ー ド メニ ュー か ど ぢ "Exit" を 選択 し て モニ タモ ー ド を 終了 し ます 。 


R OO DO 一 
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5.1 動作 環境 


・ 機 種 : 

・ OS: 

・ CPU: 

・ メ モリ : 

・ デ ィ ス プレ イ 人 解像度 : 
・CD-ROMT ライ ブ : 

・ シ リア ルポ - 上 上 : 


・ ハ ー ド ディ スク 空き 容量 


PC/AT 互換 機 

Windows 98、 Windows NT4.0、 Windows 2000 
Pentium 133MHz 以 上 

32MB 以 罰 64MB 以 上 推奨 ) 

640x 48 ド ボッ ト X 256 色 以上 

必須 

RS232C 9600/388400bp DSUB-9 オス コネ クタ ) 
20MB 以 上 


5.2 パッ ケー ジ 内 容 


画 WonderWitch 専 用 カー トリ ッ ジ 1 個 


・ フ ラッ シュ メモ リ 512KE 4Mbit): 最大 384KB 分 の プロ グラ ム フ ァ イル を 格 


・SRAM 256KR 2Mbit): 
・RTC: 
・FreyaOS、FreyaBIOS : 
・ 日 本 語 フォ ント : 


納 可能 

最大 64KB 分 の ワー ク フ ァ イル を 格納 可能 
時 計 プ カレ ンダ ー 機 能 

OS バー ジョ ン ア ッ プ 可能 

恵梨 沙 フ ォ ン ト 、 8X ボッ ト 、 第 1 第 2 水準 
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注意 : フラ ッシュ メモ リ は その 特性 と し て 数 万 回 程度 の 消去 書き 込み で 寿命 と な り ま す 。 また 、 SRA M の 内 容 お 
よび 時 刻 を 保持 する た め の パ ッ ク ア ッ プ 電池 は 、 製造 か ら 約 2 年 間 で 寿命 と な り ます 。 
重要 : フラ ッシュ メモ リ の 寿命 、 パッ クア ッ プ 電池 の 寿命 に よる 不具 合 に 関し て は 保証 の 範囲 外 に な り ます 。 重要 
な ファ イル は PC に パッ クア ッ プ を 取る よう 心がけ て くだ さい 。 
較 PC - WonderSwan 接 続 ケ ー ブ ル RS232C シ リア ル 接 続 ) 1 組 
・ ス ワン ケー ブル : EXT コネ クタ DSUB-9( オ ス ) 1 本 
・ ク ロス ケー ブル : DSUB-@ メス ) DSUB-@ メス ) 1 本 
注意 スワン ケー ブル と クロ スケ ー ブ ル を 接続 し 、 1 本 に し た 状態 で 使用 し ます 。 
mMepcsl CDROM 1 必 6.1 一 般 的 な 確認 事項 
・C ヘ ッ ダ ファ イル 、 ライ ブラ リ 、 スタ ー ト アッ プル ー チ ン お 客 様 相談 セン ター 等 に お 問い 合わ せ に な る 前 に 、 ま ず 以 下 の 項 目 を 確認 し て く 
・ サ ンプ ルソー ス だ さい 。 また 、 サポ ー ト W eb サイ ト に 関連 する 情報 が 公開 され て いな いか も 確認 し て 
・ フ ァイル 転送 ツー ル TransMagic」 くだ さい 。 
・ フ ァイル 形式 変換 ツー ル mkfent」 認 の 結果 、 WonderWitch 専 用 カー トリ ッ ジ の 故障 の 可能 性 が ある 場合 に は J 故 
・ ビ ピット マッ プ 変 換 ツ ー ル bmpcnv」 障 診断 ツー ル と 手順 」 に 従い 故障 診断 を 行っ て くだ さい 。 
・ 演奏 デー タ 変換 ツー ル sndcnv」 故障 に つい て の お 問い 合わ せ ば ユー ザ 登 録 、 ユーザ サポ ー ト に つい て 」 を 参照 し 
・ オ ン ラ イン マニ ュ ア ル て くだ さい 。 
・ 同 梱 C コ ン パ イラ ( LSI C-86 for WonderWitch、 Turbo C 2.01 英語 版 ) 
・ そ の 他 6.1.1 電源 スイ ッ チ を ON に し て も 、 画 面 が 表示 され な い 


画 画 面 左 下 の 電 源 ON マ ー ク が 点灯 し な い 
画 取 扱 説明 書 1 地 当 冊 子 ) 
1. 電池 が 入っ て いる か 
2. 電池 が な く な っ て いな いか 
3. 電池 ケー ス が 正しく セッ ト され て いる か 


ー 上 記 項 目 の す べ て を 確認 し 、 し か る べき 対処 を し て も 症状 に 変化 が な い 場合 
WonderSwan 本 体 の 故障 の 可能 性 が あり ます 。 


画 画 面 左下 の 電源 ON マー ク は 点灯 する が 、 起動 音 が し な い 


1. WonderWitch 専 用 カー トリ ッ ジ が 正しく セッ ト さ れ て いる が カー トリ ッ ジ を 抜い て 
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も う 一 度 し っ か り と 差し 込ん で みて くだ さい ) 

2. 他 の ゲー ムカ ー ト リッ ジ が 正しく 動作 する か 

3. 周辺 機器 差し 込み 口 に ヘッ ド ホン アダ プ タ を 差し て いた 場合 、 抜い て か ら 再 度 
症状 を 確認 し て くだ さい 


っ 他 の ゲー ムカ ー ト リッ ジ が 正しく 動作 する 場合 、 WonderWitch 専 用 カー トリ ッ ジ の 
故障 の 可能 性 が あり ます 。 

つ 他 の ゲー ムカ ー ト リッ ジ も 正しく 動作 し な い 場合 、 WonderSwan 本 体 の 故障 の 可 
能 性 が あり ます 。 


画 画 面 左 下 の 電源 ON マー ク が 点灯 し 、 起動 音 も する 


1. WonderWitch 専 用 カー トリ ッ ジ が 正しく セッ ト され て いる が カー トリ ッ ジ を 抜い て 
も う 一 度 し っ か り と 差し 込ん で みて くだ さい ) 

2. 他 の ゲー ムカ ー ト リッ ジ が 正しく 動作 する か 

3. コン トラ スト 調整 ダイ アル で 調整 範囲 いっ ぱい に 調整 し て みて も 表示 され な い 
か 

4. B ボ タン を 押し な が ら 電源 スイ ッ チ を ON に し て も 、 何 も 表示 され な いか 


っ 他 の ゲー ムカ ー ト リッ ジ も 正しく 動作 し な い 場合 、 WonderSwan 本 体 の 故障 の 可 
能 性 が あり ます 。 

つっ ーB ボ タン を 押し な が ら ON すれ ば 画面 が 表示 され る 場合 、 カ ー ト リッ ジ 内 の 
FreyaOS が 破損 し て いる 可能 性 が あり ます 。 

っ 上記 項 目 の す べ て を 確認 し 、 し か る べき 対処 を し て も 症状 に 変化 が な い 場 合 
WonderWitch 専 用 カー トリ ッ ジ の 故障 の 可能 性 が あり ます 。 


6.1.2 PC と WonderSwan の 間 で ファ イル 転送 が で き ない 
較 は じ め に 確認 し て お く こ と 


1. PC と WonderSwan は ケー ブル で 正しく 接続 され て いま すか 
2. WonderSwan の 電源 が 入っ て いま すか 


3. Meg が 通信 画面 に な っ て いま すか 


男 TransMagic が メッ セー ジ ダ イ アロ グ を 表示 する 
表示 され た メッ セー ジ の 内 容 に よっ て 、 次 の 項目 を 確認 し (て くだ さい 。 
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・「 通信 ポー ト の オー プン に 失敗 し まし た 」 


つ す で に シリ アル ポー ト を 使用 し て いる アプ リケーション が あり ます 。 先 に その アプ 
リケーション を 終了 し て くだ さい 。 


・「 通信 が タイ ム ア ウ ト し まし た 」 
1. ケー ブル を 接続 し た シリ アル ポー 番 繝 COM1ー4) と TransMagic の シリ アル 
ポー ト 設定 が あっ て いま すか 
2. TransMagic の シリ アル ポー ト 設定 で 通信 速度 が 38,400 に な っ て いま すか 
・「 XMODEM 転 送 は WonderWitch に よっ て キャ ン セ ル さ れ ま し た 」 
1. 転送 先 に 転送 する ファ イル と 同じ ファ イル 名 WonderWitch 転 送 形式 作成 時 に 
指定 し た ファ イル 名 ) が あり ませ ん か 
2. ファ イル エリ ア の 空き 容量 が 足り な く な っ て いま せん か 
3. 通信 中 に キャ ン セ ル ボ タン を 押し て いま せん か 
・「 WonderWitch に 接続 され て いま せん 」 
1. 接続 貝 ステ ー タ スエ リア が 緑 ) に な っ て いま すか 
っ 上 記 項 目 の す べ て を 確認 し 、 し か る べき 対処 を し て も 症状 に 変化 が な い 場合 、 
WonderWitch 専 用 カー トリ ッ ジ 、 通信 ケー ブル の 故障 の 可能 性 、 ま た は 


TransMagic の 不具 合 の 可能 性 が あり ます 。 


6.1.3 WonderSwan 同 士 で の ファ イル 交換 が で き な い 
較 は じ め に 確認 し て お く こ と 


1. WonderSwan 同士 は ケー ブル で 正しく 接続 され て いま すか 


2. 両方 の WonderSwan の 電源 が 入っ て いま すか 
3. 両方 の Meg が 通信 画面 に な か っ て いま すか 
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Meg の 画面 で の 確認 


1. 転送 先 に 転送 する ファ イル と 同じ ファ イル 名 WonderWitch 転 送 形式 作成 時 に 
指定 し た ファ イル 名 ) が あり ませ ん か 

2. ファ イル エリ ア の 空き 容量 が 足り な く な っ て いま せん か 

3. 通信 中 に キャ ン セ ル ボ タン を 押し て いま せん か 


っ 上 記 項 目 の す べ て を 確認 し 、 し か る べき 対処 を し て も 症状 に 変化 が な い 場合 、 
WonderWitch 専 用 カー トリ ッ ジ 、 通信 ケー ブル の 故障 の 可能 性 、 ま た は FreyaOS 
の 不具 合 の 可能 性 が あり ます 。 


6.1.4 OS アッ プ グ レー ド 、 バッ クア ッ プ が で きま せん 
一 は じ め に 確認 し て お く こと 


1. PC と WonderSwan は ケー ブル で 正しく 接続 され て いま すか 
2. WonderSwan の 電源 が 入っ て いま すか 
3. WonderWitch が モニ タモ ー ド に な っ て いま すか 


還 TransMagic 側 で の 確認 


1. 切断 躍 ステ ー タ スエ リア が ピン ク ) に な っ て いま すか 
2. OS アッ プ グ レー ドド 用 ファ イル に 正しい も の を 指定 し て いま すか 


っ 上 記 項 目 の す べ て を 確認 し 、 し か る べき 対処 を し て も 症状 に 変化 が な い 場合 
WonderWitch 専 用 カー トリ ッ ジ 、 通信 ケー ブル の 故障 の 可能 性 が あり ます 。 


6.2 故障 診断 ツー ル と 手順 


WonderWitch 専 用 カー トリ ッ ジ に ハー ド ウェ ア 異 常 が な いこ と を 調べ る た め に 、 自 

診断 プロ グラ ム が 用 意 さ れ て いま す 。 

WonderWitch の モニ タモ ー ド を 利用 し て OS の か わり に この プロ グラ ム を 転送 し 、 
実行 する こと に よっ て 、 WonderWitch 専 用 カー トリ ッ ジ 上 の フラ ッシュ メモ リ 、 お よび 
SRA M の 書き こみ と 読み 出し が 正常 に 行え る か どう か を 検査 し ます 。 

自己 診断 プロ グラ ム を 実行 する と カー トリ ッ ジ 上 の 情報 は すべ て 失わ れ ま す 。 重要 
な ファ イル は あら か じ め バ パッ クア ッ プ を と っ て お いて くだ さい 。 
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6.2.1 自己 診断 プロ グラ ム の 実行 手順 


1. モニ タモ ー ド で 起動 し まず ボ B ボ タン を 押し な が ら 電源 を ON する )。 

2. 自己 診断 プロ グラ ム を OS アッ プ グ レー- ド と 同じ 要領 で " WWitch 半 bin 約 elftest 
bin” を WonderWitch 専 用 カー トリ ッ ジ に 転送 し ます 。 こ の と き 、 か な ら ず 現在 の 
OS の バッ クア ッ プ を 取っ て お きま す 。 

. 再起 動 し まず モニ タメ ニュ ー の Exit” を 選択 、 ま た は 電源 再 投入 )。 

. 自己 診断 プロ グラ ム が 実行 され ます 。 

. 自己 診断 プロ グラ ム を 終了 し まず 電源 OFF)。 

. バック アッ プ し て お いた OS を WonderWitch 専 用 カー トリ ッ ジ に 転送 し ます 。 


O 〇 の QI 心 〇 


6.2.2 診断 結果 

自己 診断 プロ グラ ム を 実行 する と 、 WonderSwan 本 体 の 画面 上 に 診断 結果 が 表 
示さ れ ま す 。 すべ て の 検査 結果 が 正常 で あっ た 場合 に は 、 画面 に は 次 の よう に 表示 
され ます 。 


TEST FLASH #O..….OK 
TEST FLASH #1..…OK 
TEST FLASH #2..….OK 
TEST FLASH #3...OK 
TEST FLASH 4...OK 
TEST FLASH # お 5..….OK 
TEST SRAM #O.…OK 
TEST SRAM 者 .…OK 
TEST SRAM #.…OK 
TEST SRAM お 3..….OK 
Completedl 


異常 が あっ た 場合 に は 、 異常 が 起こ っ た 部 分 に "NG!" と 表示 され ます 。 例え ば 、 フ 
ラッ シュ メモ リ の バン ク 3 に 異常 が あっ た 場合 に は 、 画面 の 4 行 目 が 次 の よう な 表示 に 


な り ま す 。 


TEST FLASH # お 3.….NG! 


注意 異常 が あっ た 場合 に は 、 画面 に 表示 され た 内 容 を 記録 し て 、 サポ ー ト 窓口 まで ご 連絡 くだ さい 。 
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6.2.3 自己 診断 プロ グラ ム の 自動 実行 に つい て 
WonderWitch 専 用 カー トリ ッ ジ は 、 SRA M 上 の 特定 位置 に 保存 し て ある 情報 に し 
た が っ て 記録 内 容 の 正当 性 を 判定 し ます 。 
カー トリ ッ ジ の 故障 や ユー ザ プ ロ グラ ム に よる 破壊 な どの 理由 に より 、 保存 し て ある 
は ず の 情報 と 実際 に 保存 され て いる 情報 が 異な っ て いる 場合 に は 、 自己 診断 プロ グ 
ラム が 自動 的 に 実行 され ます 。 


注意 : この 機能 は OS 内 部 に 組み 込ま れ て お り 、 ユー ザ が モニ タモ ー ド を 使っ て 自己 診断 プロ グラ ム を 転送 する 
必要 は あり ませ ん 。 また 、 実行 後に OS を 再 転送 する 必要 も あり ませ ん 。 

自動 実行 され た 際 に 異常 が あっ た 場合 に は 、 画面 に 表示 され た 内 容 を 記録 し て 、 サポ ー ト 窓口 まで ご 連 
絡 く だ さい 。 


引 
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第 7 章 
ュー ザ 登 録 ユーザ ポポ - 下 に DO い 記 


7.1 サポ ー ト Web サ イト 


ユー ザ 登 録 お よび ユー ザ サ ポー ト は JJ サポ ー ト Web サ イト 」 で 行い ます 。 また OS の 
アッ プ グ レー ド に 関す る 情報 や 技術 情報 、 取扱 説明 書 の 正誤 表 な ども ここ で 提供 され 
ます 。 

ユー ザ サ ポー ト へ お 問い 合わ せ の 前 に は 必ず 、 サポ ー ト Web サ イト 上 に 関連 情報 
が 掲載 され て いな いか どう か 確認 し て いた だ く よ う お 願い いた し ます 。 


田 WonderWitch サ ポー ト Web サ イト 


http:/Avonderwitch.qute.co.jp/ 


7.2 ユー ザ 登 録 


ユー ザ 登 録 お よび 登録 し た 内 容 の 変更 ば サポート Web サ イト 」 で 実施 し て いた だ 
きま す 。 

ユー ザ 登 録 は ユー ザ サ ポー ト を 受け る た め に 必要 で す の で 、 必ず 実施 し て いた だ 
く よ う お 願い いた し ます 。 また 登録 ユー ザ の 方 に は 、 バー ジョ ン ア ッ プ や 製品 に 関す る 
重要 な お 知ら せ を 電子 メー ル で 配信 する 情報 サー ビス も 行っ て いま す 。 


注意 ユーザ 登 録 に は 製品 の シリ アル ナン バー が 必要 で す 。 シリ アル ナン バー は CD-ROM ケ ー ス の シー ル に 表記 
され て いま す 。 
注意 メー ル ア ド レス 等 、 登録 し て いる 内 容 に 変更 が 生じ た 場合 に は 、 速やか に 登録 内 容 を 変更 し て くだ さい 。 
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製品 を 譲渡 する 場合 、 必ず 登録 の 抹消 を し て くだ さい 。 登録 の 抹消 が され て いな 
い 場合 、 ソ フト ウェ ア 使用 許諾 契約 上 の 譲渡 と し て は 認め ら れず 、 譲渡 され た 方 の ユ 
ー ザ 登録 お よび ユー ザ サ ポー ト は で きま せん 。 また 、 一 旦 譲渡 し た 製 量 同一 シリ ア 
ルナ ン バ ー ) は 、 譲渡 し た 方 が 再び ユー ザ に な る こと は で きま せん 。 詳し く は ソフ トウ 
ェ ア 使 用 許諾 契約 書 を 参照 し て くだ さい 。 


7.3 ユー ザ サ ポー ト 


ユー ザ サ ポー ト は ユー ザ 登 録 し て いる 方 の み が 受け る こと が で きま す 。 

ユー ザ サ ポー ト は 電子 メー ル 、 お よび サポ ー ト Web サ イト を 通じ て 行わ れ ま す 。 電話 
や FAX に よる サポ ー ト は 行っ て お り ま せん 。 また 、 電子 メー ル で は な く 、 W eb 上 で の 回 
答 に な る 場合 や 、 回 答 に 時 間 の か か る 場合 も あり ます 。 


還 ユ ー ザ サポ ー ト 用 メー ル ア ド レス 
wonderwitch-support@ bandai.co.jp 


注意 お 問い 合わ せ の 前 に は 必ず 、 サポ ー ト Web サ イト 上 に 関連 する 情報 が な いか 確認 し て くだ さい 。 

注意 ユーザ サ ポー ト で は 、 PC 操作 、 C 言 語 、 一 般 的 な プロ グラ ミン グ 、 同 梱 C コ ン パ イラ 、 コン トリ ビュ ーション 等 
に つい て の お 問い 合わ せ に は お 答え で きま せん 。 

注意 ユー ザー サポ ー ト に アク セス する 場合 は 、 メ ー ル アド レス 、 ホー ムペ ー ジ アド レス を よく 確か め て 、 お 間違い 
の な いよ うに し て くだ さい 。 

注意 : 同 梱 C コ ン パ イラ の 開発 元 に 対す る お 問い 合わ せ は 絶対 に し な いで くだ さい 。 


7.4 製品 お よび 故障 に つい て の お 問い 合わ せ 
製品 に つい て の 一 般 的 な お 問い 合わ せ 、 お よび ハー ド ウェ ア 故障 の ご 相談 に つい 


て は 、 以下 の バン ダ f お 客 様 相談 セン ター また は 製品 お 問い 合わ せ 用 メー ル ア ド レス 
まで ご 連絡 くだ さい 。 
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ユー ザ 登 録 、 ユ ー ザ サポ ー ト に つい て 


(お 買い 上 げ の お 客 様 へ ) 商品 に つい て お 気づき の 上 京 が ご ざい まし た 
ら 、 お 客 様相 談 セ ンタ ー ま で お 問い 合わ せく だ さい 。 住所 、 電 話 番号 、 
保護 者 の 方 と お 子 様 の お 名 前 ・ お 年 も 必ず お 知ら せく だ さい 。 


パン ダイ お 客 様 相談 セン ター 
台東 区 動 形 1-4-10 吾 111-8081 婦 03-3847-6666 


@ 電 話 受付 時 間 月 一 金曜 日 (祝日 を 除く )10 時 一 16 時 
人 電話 番号 は よく 確か め て お 間違い の な いよ う ご 注 意 く だ さい 。 


画 製 品 お 問い 合わ せ 用 メー ル ア ド レス 


wonderwitch-info@ bandai.co.jp 


注意 : 保証 を 受け る 際 に は 、 保証 書 お よび 購入 し た 日 を 証明 する も の が 必要 に な り ま す 。 保証 書 は 当 冊 子 冒頭 
部 分 に あり ます 。 
注意 メー ル ア ド レス を よく 確か め て お 間違い の な いよ う ご 注意 くだ さい 。 
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8.1 WonderWitch サ ポー ト Web サ イト 


WonderWitch の 公式 サポ ー ト サイト で す 。 最新 情報 、 アッ プ デ ー ト モジ ュー ル 、 ユー 
ザー 登録 、 サポート 窓口 な ど が あり ます 。 


http:/ 人 vonderwitch.qute.co.jp/ 


8.2 バン ダイ 


WonderWitch の 発売 元 で す 。 WonderSwan 本 体 お よび 周辺 機器 の 情報 な ど が 
得 ら れ ま す 。 


http:/ 人 vww.bandai.co.jp/ 
http:/Avww.swan.channel.orJp/ 


8.3 キュ ー ト 


WonderWitch の 開発 元 で す 。 


http:/ 人 vww.qute.co.jp/ 
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9.4。 下 エス アイ ツ ャ パン 
「 LSI C-86 for WonderWitch」 の 開発 元 で す 。 
http:/ 人 ww.lsj.coJjp/ 
注意 WonderWitch に 同 和 さ れ て い ダ LSI C-86 for WonderWitch」 に 関す る 問い 合わ せ は 、 エル エス ア 
イジ ャ パン で は 受け 付け て お り ま せん 。 また J LSI C-86 for WonderWitch」 の 使用 条件 等 に つい て は 、 


Magical CD-RNOM の \ WWitch\ lsic8eww に 収録 され て いる " LICENSETXT "ファ イル を 参照 し て くだ 


さい 。 


8.5 イン プラ イズ 
「 Turbo C 20」 の 開発 元 で す 。 
http:/ 人 vww.inprise.co.」jp/ 


注意 : WonderWitch に 同 梱 さ れ て い ず TurboC 20」 に 関す る 問い 合わ せ は 、 イ ンプ ライ ズ で は 受け 付け て お り 
ませ ん 。 また J Turbo C 20」 の 使用 条件 等 に つい て は 、 Magical CD-ROM の \TURBOC に 収録 され て 
いる "License.txt" フ ァイル を 参照 し て くだ さい 。 
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4Yorsyossa ん 


葛 9 章 
生 巨 ! 目 間 朋 朋 | 


WonderWitch 用 プロ グラ ム を 開発 する 手順 を 、 セッ ト ア ッ プ か ら 実行 まで 順 を 追っ 
て 解説 し ます 。 また 、 キッ ト に 納め られ て いる サン プル プロ グラ ム も 紹介 し ます 。 


9.1 は じ め に 知っ て お く こ と 


9.1.1 開発 手順 
WonderWitch 専 用 カー トリ ッ ジ で 実行 する プロ グラ ム の 開発 は 次 の 手順 で 行い ま 


す 。 


1. 開発 環境 の 構 穫 セッ ト アッ プ ) 

2. ソー ス フ ァ イル の 編集 

3. ソー ス フ ァ イル の コン パイ ル また は アセ ン ブ ル ) 
4. オブ ジェ クト ファ イル の リン ク 

5. WonderWitch 上 で 利用 可能 な 形式 へ の 変換 


9.1.2 ファ イル 
プロ グラ ム 開 発 に 際 し て 、 さまざま な 種類 の ファ イル が 利用 され ます 。 ここ で は 、 代 
表 的 な も の に つい て 、 フ ァイル の 内 容 と 役割 を 簡単 に 説明 し ます 。 


て 生成 し ます 。 

*.ib ライ ブラ リフ ァイル 。 オブ ジェ クト ファ イル を ライ ブラ リア ン で まとめ 
て 生成 し ます 。 

*.bin リン ク 済み バイ ナリ ファ イル 。.obj フ ァイル と .lib フ ァイル を リン ク し 
て 生成 し ます 。 

*. 村 WonderWitch 転 送 形式 ファ イル 。.bin フ ァイル を mkfent コ マン ド で 


WonderWitch 上 に 配置 で きる 形式 に 変換 し た も の で す 。 変換 に 必 
要 な 情報 は 、.cf フ ァイル に 指定 し ます 。 

*.CF mkfent 情 報 フ ァイル 。 ファ イル を mkfent コ マン ド で WonderWitch 
転送 形式 に 変換 する 際 に 利用 する 情報 を 記述 し ます 。 詳し い 書 式 
に つい て は 、 リ ファ レン スマ ニュ アル の C.1 mkfent ファ イル 形 
式 変換 ツー ル )」 を 参照 し て くだ さい 。 

makefile make コ マン ド 用 、 依 存 関係 記述 ファ イル 。make コ マン ド 、 
kmmake コ マン ド を 利用 し て 、 一 連 の 手順 を 自動 実行 する 際 に ファ 
イル 間 の 依存 関係 と 、 実行 すべ き コ マン ド を 記述 し ます 。 


9.2 セッ ドア ッ プ 


WonderWitch を 利用 し て プロ グラ ム を 開発 する に は 、 お 使い の PC に 必要 な ツー ル 
群 を イン スト ー ル し 、 いく つか の 設定 を 行う 必要 が あり ます 。 

以下 の 説明 を よく 読ん で 、 お 使い の コン ピュ ー タ 環境 に 合わ せ て 適切 に 設定 し て く 
だ さい 。 


9.2.1 ツー ル 群 の イン スト 一 ル 
ユー ザー ズ マ ニュ アル の 1.5 PC へ の イン スト ー ル 」 に し た が っ て 、 Magical CD- 


ROM か ら PC ヘ ツ ー ル 群 を イン スト ー ル し ます 。 


9.2.2 設定 ファ イル の 編集 

実際 の イン スト ー ル 位置 に あわ せ て 、 WWitch フ ォ ル ダ 以下 に ある 設定 ファ イル 群 の 
内 容 を 適宜 編集 し ます 。 

標準 的 な イン スト ー ル 位置 と 、 修正 すべ き 記述 は 以下 の 通り で す 。 


イン スト ー ル 内 容 標準 イル オー ル 位 置 修正 対象 


ファ イル 名 内 容 


*.C C ソ ー ス ファ イル 。 プロ グラ ム の 本 体 部 分 を 記述 し ます 。 

*h C ヘ ッ ダ ファ イル 。.c フ ァイル で 利用 する 定数 の 定義 や 、 関数 ・ 型 
の 宣言 を 行い ます 。 

*.OD オブ ジェ クト ファ イル 。 ソー ス フ ァ イル を コン パイ ル 、 アセ ン ブ ル し 
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WWitch フ ォ ル ダ C:\WWitch 以下 の ファ イル 群 の C:*VWitch と な っ て 
いる 個所 すべ て 
・bin 湊 etup.bat 
・lsic86oin\ lcc86ww 


TurboC C:\TC 以下 の ファ イル 群 の C:\TC と な っ て いる 
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(利用 する 場合 の み ) 個所 すべ て 
・bin 湊 etup.bat 


9.2.3 MS-DOS プ ロン プ ト の 起動 と 設定 


プロ グラ ム 開 発 は 、 MS-DOS プ ロン プ ト を 利用 し て 行い ます 。 Windows 98 の 場合 
で あれ ば [ スタ ー ト ] メ ニュ ー 耳 プロ グラ ム ] 士 MSDOS プ ロン プ ト ] を 起動 し ます 。 
Windows 2000 の 場合 は [ スタ ー ト ] メ ニュ ー 二 プロ グラ ム ] 士 アク セ サ リ ] 士 コマ ン 
ド プ ロン プ ト ]、 Windows NT 4x の 場合 に は [ スタ ー ト ] メ ニュ ー 士 プロ グラ ム ] 十 コ 
マン ド プロ ンプ ト ] を 、 それ ぞ れ ご 利用 くだ さい 。 

MS-DOS プ ロン プ ト 上 で 開発 用 ツー ル 群 を 正しく 利用 する に は 、 コ マン ド サー チ パ 
ス な どの 設定 が 必要 で す 。 WWitch\bin フ ォ ル ダ の 中 に 、 こ の 設定 を 行う た め の バ 
ッ チ ファ イル setup.bat) が 用 意 さ れ て いま す の で 、 MS-DOS プ ロン プ ト か ら こ れ を 実 
行 し ます 。 


>\WW ユ EC われ ぎ わ ュ n ぎ SG ヒ uD . わ a モ 


注意 : 実際 に イン スト ー ル し た 場所 に 合わ せ て 、 パス の 指定 を 行っ て くだ さい 。 


9.3 ソー ス フ ァ イル の 編集 


テキ スト エギ タ を 用 いて ソー ス フ ァ イル を 人 作成 し ます 。 例え ば 、 画面 の 左上 に ′ Hello 
World!" と 表示 する プロ グラ ム で あれ ば 、 以下 の よう に 記述 し ます 。 


# ュ nc1ude <sys/bos .h> 


Yod man ( ) 
{ 
七 G モ SC て GGnm_ ユエ ロ ュ エモ ( ) : 


も @Gx 上 _pu モ 上 _ Ss モエ nd(0, 0, "He11o, Wor1dqd!"): 


プロ グラ ム の 編集 が 終わ っ た ら 、 .c" で 終わ る 名 前 を つけ て ファ イル に 保存 し ます 。 
この と き 、 プロ グラ ム の 内 容 を 適切 に 表す 名 前 を つけ る よう に し ます 。 例え ば 、 上 記 の 
プロ グラ ム で あれ ば 、 helloc"” の よう な 名 前 が 良い で し ょ う 。 
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編集 に 用 いる テキ スト エギ イタ は メモ 帳 や 秀丸 な ど 、 普段 使っ て いる も の で 構い ませ 
ん が 、 以下 の 点 に 注意 し て くだ さい 。 


・ テ キス ト 形式 で 保存 する 。 
・ 拡 張子 を .cC と する 。 


特に メモ 帳 を お 使い の 場合 に は 、 標準 で ば ' .txt" と いう 拡張 子 で ファ イル を 保存 す 
る の で 注意 が 必要 で す 。 


注意 「 LSI C-86 for WonderWitch」J Turbo C 20」 の いずれ で も コン パイ ル で きる よう に する た め に は 、 フ ァ 
イル 名 8 文字 + 拡張 子 3 文字 で 収まる よう に ソー ス フ ァ イル の 名 前 を つけ ます 。 


9.4 コン パイ ル 


コン パイ ラ を 用 いて ソー ス フ ァ イル を 処理 し 、 実行 形式 を 得 ます 。 

同 柚 の コン パイ ラ は 、 MS-DOS プ ロン プ ト 上 で 実行 し ます 。 例え ば 、 前 出 の helloc を 、 
同 梱 び LSI C-86 for WonderWitch」 を 用 いて コン パイ ル す る 場合 に は 、| 923 
MS-DOS プ ロン プ ト の 起動 と 設定 」 で 説明 し た 初期 設定 を 済ま せ て か ら 、 MS-DOS プ 
ロン プ ト 上 で 次 の よう に 実行 し ます 。 


>1cc86 -o he11o.bin he11o.c 


ソー ス フ ァ イル の 内 容 に 問題 が な く 、 正常 に コン パイ ル が 行わ れ た 場合 、 hellobin 
と いう ファ イル が 生成 され ます 。 

な に か 問題 が ある 場合 に は 、 コ ン パ イラ が エラ ー メ ッ セ ー ジ を 表示 し ます 。 この 場合 
に は 、 hello.bin フ ァイル は 生成 され ませ ん 。 

例え ば 光 セミ コロ ン ) と すべ き と こ ろ を ",” カンマ) に し て し まっ た 場合 に は 、 次 
の よう な エラ ー メ ッ セ ー ジ が 表示 され る で し ょ う 。 


he ユエ 1O.C 7: Syn モ axk G エ エ O エ near 「]" 
エラ ー メ ッ セ ー ジ は 、 フ ァイル 名 、 エラ ー を 検出 し た 行 番号 、 エラ ー の 内 容 を 表し て 


いま す の で 、 エラ ー メ ッ セ ー ジ が 表示 され な く な る まで 、 ソ ー ス ファ イル の 修正 と コン パ 
イル を 繰り 返し ます 。 
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9.5 WonderWitch 転 送 形 式 へ の 変換 


.bin フ ァイル を 生成 し た ら 、 W onderWitch 専 用 カー トリ ッ ジ に 転送 で きる 形式 
( WonderWitch 転 送 形式 ) に 変換 し ます 。 

Windows 系 の OS で 変換 する に は 、 付属 の ファ イル 形式 変換 ツー ル mkfent」 を 用 
いま す 。 mkfent は 、 .cf フ ァイル に 記述 し た 内 容 に し た が っ て .bin フ ァイル を 必 フ ァイル に 
変換 し ます 。 

例え ば 、 hellojbin フ ァイル を 


・hello と いう 名 前 で WonderWitch 上 に 配置 
・ フ ァイル の 説明 ば ハロ ー」 

・ 読み 書き 、 実行 可能 

・PC 上 の 出力 ファ イル 名 ば hello.fx" 


と いう 条件 で 変換 する に は 、 


name: hello 
info: ハロ ー 
mode: 7 

source: hello.bin 
output: hello.fx 


の よう に 記述 し た ファ イル hellocf と し ます ) を 用 意 し 、 次 の よう に mkfent コ マン ド を 
実行 し ます 。 


>mkfFen ヒ he11o.oE 
その 結果 、 hello 人 が 生成 され ます 。 


な お 、 .cf フ ァイル の 書式 の 詳細 に つい て は C.1 mkfen《 ファ イル 形式 変換 ツー ル )」 
を 参照 し て 下さ い 。 


9.6 転送 
mkfent コ マン ド に よっ て 生成 され た 材 フ ァイル を WonderWitch 専 用 カー トリ ッ ジ に 
転送 し ます 。 
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Windows 系 の OS で ファ イル を 転送 する に は 、 付 属 の ファ イル 転送 ツー ル 
「 TransMagic」 を 用 いま す 。 TransMagic の 使い 方 に つい て は 、 ユー ザー ズ マ ニュ ア 
ル の 24 カー トリ ッ ジ へ の 転送 」 を 参照 し て くだ さい 。 

Windows 系 以外 の 場合 に は 、 XMODEM プ ロト コル に 対応 し た 通信 ソフ ト な ど を 
用 いま す 。 詳し く は 、 ユー ザー ズ マ ニュ アル の 第 3 章 高度 な 使い 方 」 を 参照 し て くだ 
さい 。 


9.7 実行 
WonderWitch 専 用 カー トリ ッ ジ に 転送 し た プロ グラ ム は 、 シ ェ ル を 用 いて 実行 し ま 


す 。 標準 シェ ル Meg」 で の 実行 方 法 に つい て は 、 ユー ザー ズ マ ニュ アル の 25 プ 
ログ ラム の 実行 と ファ イル 操作 」 を 参照 し て くだ さい 。 


9.7.1 make コ マン ド の 利用 

以上 が 、 WonderWitch で の プロ グラ ム 開 発 の 流れ で す 。 非常 に 多く の 手順 が 必要 
で 、 場合 に よっ て は 繰り 返し 何 度 も 実行 し な く て は な り ま せん 。 

ファ イル 同士 の 依存 関係 を" makefile" と いう 名 前 の ファ イル に 記述 し て お け ば 、 毎 
回 手 で 実行 し なく て も 、 make コ マン ド を 実行 する だ け で 一 連 の 手順 を 自動 的 に 実 
行 す る こと が で きま す 。 修正 や コン パイ ル を 何 度 も 行う 場合 に は 大 変 便利 で す の で 、 
ぜひ 、 利用 する こと を お すす めし ます 。 

「 LSI C-86 for WonderWitch」 の フォ ル ダ に kmmake コ マン ド が 、 ま た 、 TurboC 
20」 の フォ ル ダ に make コ マン ド が それ ぞ れ 収録 され て いま す 。 各 コマ ンド の マニ ュ ア 
ル な ど を 参照 し て 、 利用 し て くだ さい 。 

makefile の 記述 の 仕方 に つい て は 、 WWitch\samples に 収め られ て いる 各 サ ン 
プル の makefile が 参考 に な る で し ょ う 。 WWitch\samples に ある 、 makefile.lcc を 
makefileinc に コピ ー す れ ば デフ ォ ル ト の コン パイ ラ と し て LSI C-86 for Wonder 
Witch を 使用 し 、 makefiletcc を makefileinc に コピ ー す れ ば 、Turbo C 20 を 使用 
し ます 。 

な お 、 各 サ ンプ ル の フォ ル ダ に ある makefile は 、 kmmake コ マン ド の 書式 に し た が 
っ て いま す 。 Turbo C 20 付 属 の make コ マン ド を 利用 する 場合 に は 、 修正 が 必要 と な 
り ま す の で ご 注意 くだ さい 。 


9.8 サン プル 一 覧 
WWitch\samples に 、 WonderWitch の 機能 の 利用 法 を 示す サン プル 群 が 収 録 さ 
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れ て いま す 。 すべ て の 機能 の サン プル が 揃っ て いる わけ で は あり ませ ん が 、WonderWitch 
で プロ グラ ミン グ す る 際 に は 必ず 役に立つ も の な の で 、 参考 に し て だ さい 。 


較 hello 
画面 上 に メッ セー ジ を 表示 し ます 。 テキ スト 画面 BIOS と キーBIOS の サン プル で す 。 
また 、 リ モー トシ ェ ル で 渡さ れ た コマ ンド ライ ン 引 数 を 参照 する サン プル で も あり ます 。 


園 calendar 
カレ ンダ を 表示 し ます 。 RTC 機 能 の サン プル で す 。 X キ ー 群 で 、 年 、 月 が 変化 し ま 
す 。 また 、Y4 キ ー で プロ セス の 実行 を 一 旦 停 止 し まず yield 機 能 )。 


圏 random 


乱数 を 表示 し ます 。 標準 ライ ブラ リ 関数 の サン プル で す 。 


圏 scroll 
画面 を スク ロー ル し ます 。 画面 制御 BIOS の サン プル で す 。 X キ ー 群 で 上 下 左右 に 
スク ロー ル し ます 。 


園 copy 

ファ イル の 内 容 を コピ ー し ます 。 FILE 構 造 体 を 使っ た ファ イル アク セス の サン プル で 
す 。 リモ ー ト シェ ル で 実行 し 、 コ ピー 元 、 コピ ー 先 の ファ イル 名 を それ ぞ れ コマ ンド ライ 
ン 引 数 で 指定 し ます 。 


較 |s 
/rom0 に 格納 され て いる ファ イル の 一 覧 を 表示 し ます 。 低 レベ ル |/O ラ イブ ラリ 関数 
の サン プル で す 。 


圏 version 
FreyaOS、 FreyaBIOS の バー ジョ ン を 表示 し ます 。 標準 ライ ブラ リ 関数 の サン プル 
で す 。 


田 pid 
プロ セス に 関す る 情報 を 表示 し ます 。 プロ セス 状態 取得 機能 群 の サン プル で す 。 
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男 Ds 
プロ セス 群 に 関す る 情報 を 一 覧 表示 し ます 。 プロ セス 状態 取得 機能 群 の サン プル 
で す 。 


回 yield 

Y4 キ ー で プロ セス の 実行 を 一 旦 停止 し 、 他 の プロ セス に 実行 権 を 委譲 し まず yield 
機能 )。 

カレ ンダ も yield 機 能 を 持っ て お り 、 こ の サン プル と 切り 替え な が ら 実行 すれ ば 、 プ 
ロ セ ス 切 り 替 え の 様 子 を 実感 で きま す 。 


| 昌 

イン ダイ レク トラ イブ ラリ を 利用 し 、 画面 に メッ セー ジ を 表示 し ます 。 ユー ザ 定 義 イ ン 
ダイ レク トラ イブ ラリ の サン プル で す 。 

詳し く は J 99 ユー ザ |IL の 実装 と 利用 」 を 参照 し て くだ さい 。 


田 procil 
ユー ザ 定 義 の ProclL を 利用 し 、 プロ セス 制御 機能 群 の 呼び 出し ご と に 、 画面 に メ 
ッ セ ー ジ を 表示 し ます 。 標準 イン ダイ レク トラ イブ ラリ を 置き 換え る サン プル で す 。 


9.9 ユー ザ IL の 実装 と 利用 


9.9.1 イン タダ イレ クト ライ ブラ リ の 開発 
イン ダイ レク トラ イブ ラリ の 開発 手順 は 以下 の 通り で す 。 


1. IL 構造 体 の 型 定義 

開発 する ライ ブラ リ が 提供 する 関数 群 を メン バー と し て 持つ IL 構造 体型 を 定義 し 、 
この 定義 を 含む ヘッ ダー ファ イル を 作成 し ます 。 すべ て の 関数 は 、 far 関 数 と し て 宣言 
する 必要 が あり ます 。 


2. ライ ブラ リ 関数 群 の 実装 
関数 群 を 実装 し ます 。 すべ て の 関数 は 、 far 関 数 と し て 定義 する 必要 が あり ます 。 


3. IL 構造 体 の 定義 
実装 し た 関数 群 へ の ポイ ンタ を 含む IL 構造 体 を 定義 し ます 。 iliblL は 、 こ の 構造 体 
の 内 容 を 用 いて 実行 時 に アド レス 解決 を 行い ます 。 また 、 こ の 構造 体 の 実体 は 実行 
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可能 形式 の 先頭 に 配置 され る 必要 が あり ます 。 


4. 専用 スタ ー ト アッ プル ー チ ン の リン ク 

スタ ー ト アッ プル ー チ ン と し て cOilib.obj を リン ク し ます 。 cOilib.obj は 、 い くつ か の IL 用 
ユー テディ リティ 関数 を 含ん で いま す 。 な お 、 イ ンダ イレ クト ライ ブラ リ を 実装 する 際 に は 以 
下 の 点 に 留意 する 必要 が あり ます 。 


還 値 を 書き 換え る 変数 は auto 変 数 に し な く て は な ら な い 

イン ダイ レク トラ イブ ラリ は 、 通常 の エ ユー ザ プ ロ グラ ム と 異な り 、 初期 化 済み デー タ を 
SRA M 上 に 転送 せ ず 、 ファ イル シス テム 上 に ある 状態 の まま 参照 し ます 。 し た が っ て 、 初 
期 化 済み デー タ は すべ て 書き 換え 不可 と な り ます 。 値 が 書き 換わる 変数 は すべ て auto 
変数 と し て スタ ッ ク 上 に と っ て くだ さい 。 


固 DS の 値 が 正しく 設定 され て いな い 

イン ダイ レク トラ イブ ラリ 自身 の デー タ は 、 前 述 の よう に 、 ファ イル シス テム 上 に 存在 し 
ます が 、 ラ イブ ラリ 関数 が 呼び 出さ れる 時 点 で は 、 DS は SRAM 上 の ユー ザ デ ー タ 領 
域 を 指し て いま す 。 この た め 、 初期 化 済 み デ ー タ を 普通 に アド レス 参照 する と 、 正しい 
値 が 得 ら れ ま せん 。 これ を 回 避 す る た め に は 、 以下 の いずれ か の 方 法 を 用 いま す 。 


・ 初 期 化 済み デー タ を 参照 する 前 に 、DS を 正しく 設定 する 

ファ イル シス テム 上 の 初期 化 済 み デ ー タ を 指す よう に DS を 設定 する 方 法 で す 。 
cOilib.obj に 含ま れる IL 用 ユー ティ リティ 関数 、il_get_ds() を 用 いて 、 実行 時 の 初期 化 
済み デー タ の セグ メン ト 値 が 得 られ ます 。 


・ 初 期 化 済み デー タ の アド レス を 、 CS の 値 を 用 いて far ア ドレ ス に 変換 する 

実行 時 の CS の 値 を 利用 し て 、 デー タ の アド レス を far ア ドレ ス に 変換 する 方 法 で す 。 
cOilib.obj に 含ま れる IL 用 ユー ティ リティ 関数 、il_to far() を 用 いて near ポ イン タ を far 
ポイ ンタ に 変換 し ます 。 


画 | 構造 体 を テキ スト セグ メン ト の 先頭 に 配置 する 

各 関 数 へ の ポイ ンタ を 保持 する IL 構造 体 が 、 テキ スト セク メン ト の 先頭 に 配置 され 
る よう に リン ク し ます 。 

これ を 行う に は 、 以下 の いずれ か の 方 法 を 用 いま す 。 


・ IL 構造 体 の 定義 を アセ ン ブ ラ で 記述 し 、 テキ スト セグ メン ト に 配置 
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・IL 構 造 体 を 格納 する デー タ セ グ メ ント の 名 前 、 グ ルー プ 名 、 クラ ス 名 を テキ スト 
セグ メン ト と 同一 に 設定 


サン プル で は 、 IL 構造 体 の 定義 を 1 つの ファ イル に 分 離し 、 こ の ソー ス フ ァ イル の み 
デー タ 群 が テ キス ト セグ メン ト に 配置 され る よう に 、 コン パイ ズ Turbo C) の オプ ショ 
ン を 用 いて 制御 し て いま ず \WWitch\samples\il\makefile 参 照 )。 


9.9.2 イン ダイ レク トラ イプ ラリ の 利用 
イン ダイ レク トラ イブ ラリ の 関数 を ユー ザ プ ロ グラ ム か ら 利用 する 手順 は 、 以下 の よう 
に な り ます 。 


1. IL 構造 体 の 定義 

利用 する ライ ブラ リ の 機能 セッ ト を あら わす IL 構造 体 を 定義 し ます 。 IL 構造 体型 は 、 
通常 、 利用 する ライ ブラ リ の 配布 キッ ト に 付属 する ヘッ ダー ファ イル に 定義 され て いま 
す の で 、 こ れ を イン クル ー ド し ます 。 


2. イン ダイ レク トラ イブ ラリ の 配置 

イン ダイ レク トラ イブ ラリ 本 体 の ファ イル を /rom0 に 配置 し ます 。 通常 、 イン ダイ レク トラ 
イブ ラリ ファ イル は 、 @foo の よう に " @" で 始ま る 名 前 を 持ち ます 。 また 、 ファ イル 属性 と 
し て 、 FMODE_ILIB フ ラグ が セッ ト さ れ て いま す 。 


3. イン ダイ レク トラ イブ ラリ の 参照 
/rom0 に 配置 され て いる イン ダイ レク トラ イブ ラリ を 、 その ファ イル 名 で 参照 し ます 。 こ 
の 機能 は 、 iliblL に よっ て 提供 され ます 。 


4. ライ ブラ リ 関数 の 呼び 出し 
アド レス 解決 され た IL 構造 体 の メン バー 関数 を 呼び 出し ます 。 


9.9.3 サン プル コー ド 
実際 に 2 つの 関数 を 持つ ユー ザ IL を 定義 、 実装 し て 利用 する 例 が サン プル 集 に 収 
め ら れ て いま す 。 


・FoolL の 定義 WVWitch 光 amples 剖 緒 oo.h) 


・FoolL の 実装 WVWitch 光 amples 首 閉 oo.c) 
・FoolL を 利用 する プロ グラ バ WWitch 約 amples 痢 北 ootestc) 
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・ サ ンプ ルコ - ド 用 の makefile WWitchSamples 当 Ifmnakefile) 


この レク トリ で make し て 得 られ る 、 foo.il が イン ダイ レク トラ イブ ラリ で す 。 そし て 、 
footestfx に 得 ら れる プロ グラ ム が 、 その 機能 を 利用 する サン プル プロ グラ ム で す 。 い 
ずれ も /rom0 に 配置 し ます 。 /rom0/footest を 実行 する と 、 @foo の 機能 を 利用 する 
様子 が わか り ま す 。 
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上 上 上 / 旧 7 六 目 紳 ( 四 ノ 還っ 較 人 直 


10.1 全体 構成 


WonderWitch は 以下 の モジ ュー ル 群 が 連携 し て 動作 し て いま す 。 


WonderWitch ア ー キ テク チャ 罰 


田 コ ユーザ アプ リケーション 
ユー ザ が 作成 する プロ グラ ム で す 。 ライ ブラ リ 関数 群 を 通じ て 、 オ ペレ ー デ ィング シス 
テバ OS) や BIOS が 提供 する 機能 を 利用 し ます 。 通常 は C 言 語 で 記述 し ます 。 


較 ラ イブ ラリ 関数 群 

ユー ザ ア プ リケーション から 呼び 出さ れる 機能 群 の モジ ュー ル で す 。 WonderWitch 
独自 の 機能 の ほか に 、 コ ン パ イラ に 付属 の 機能 を 利用 する こと が で きま す 。 ユー ザ ア 
プリ ケー ショ ン を 作成 する と き に 結合 され る 通常 の ライ ブラ リ と 、 実行 時 に ファ イル 名 を 
通じ て 参照 し 、 結合 する 間接 ライ ブラ リバ イン ダイ レク トラ イブ ラリ ) が あり ます 。 
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オ ペレ ー テ ィング シス テバ FreyaOS ) 

BIOS が 提供 する 機能 を 、 論理 的 な ソフ トウ ェ ア モ ジュ ー ル と し て 利用 で きる よう に 包 
み 込 む モ ジュ ー ル で す 。 

以下 の 機能 ブロ ッ ク に 分 けら れ ま す 。 


・ フ ァイル シス テム 
・ プ ロ セ ス 管 理 
・ イ ンダ イレ クト ライ ブラ リ 操作 


還 BIOS FreyaBIOS) 

WonderWitch 専 用 カー トリ ッ ジ お よび WonderSwan 本 体 の 物理 的 な モジ ュー ル 群 
が 提供 する 機能 を 、 よ り 上 位 の ソフ トウ ェ ア か ら 利用 する た め の イ ンタ ー フ ェ イ ス を 提供 
し ます 。 また 、 OS の 送受 信 機 能 も 提供 し ます 。 


圏 ハ ー ド ウェ ア 

WonderSwan 本 体 、 お よび WonderWitch 専 用 カー トリ ッ ジ が も つ ハ ー ド ウェ ア 機 能 
を 提供 し ます 。 WonderWitch 専 用 カー トリ ッ ジ に は 、 以下 の ハー ド ウェ ア が 搭載 され 
て いま す 。 


・ フ ラッ シュ メモ ル 512KB、 う ち ユ ー ザ 領域 は 384KB) 
・SRAM 256KB、 シ ステ ム 使 用 領域 を 含む ) 
・ カ レン ダ 時 計 


10.2 BIOS 


BIOS は 、 Basic Input Output System の 略 で 、 ハー ドウ ェ ア が 提供 する 機能 を 上 位 
レベ ル の ソフ トウ ェ ア か ら 利用 する た め の イ ンタ ー フ ェ イ ス を 提供 し ます 。 

WonderWitch 専 用 カー トリ ッ ジ に は J FreyaBIOS」 を 搭載 し て いま す 。 FreyaBIOS 
は 、 カ ー ト リッ ジ 上 の フラ ッシュ メモ リ 中 、 書き 換え る こと が で き な い 領域 プロ テク ト 領 
域 ) に 記録 され て いま す が 、 モニ タ 機 能 を 用 いて OS の 入れ 替え を 行う こと で 「 第 24 章 
OS の アッ プ グ レー ド 」 参 照 )、 将来 の 機能 拡張 や 修正 版 へ の 差し 換え が 行え ます 。 

シス テム の 内 部 で は ソフ トウ ェ ア 割 り 込 み を 用 いて FreyaBIOS の 機能 を 利用 し て い 
ます が 、 特別 な 理由 が な い 限 り 、 ユー ザ プ ロ グラ ム で は C 言 語 用 ライ ブラ リ 関数 群 を 
経由 し て 呼び 出し ます 。 どう し て も パフ ォ ー マ ンス を 上 げ る 必要 が ある 場合 に は 、 以下 
の 手順 で 直接 呼び 出し ます 。 
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1. パラ メー タ を レジ スタ に 設定 する 。 
2. 利用 する 機能 グル ー プ に 応じ た ソフ ト ウェ ア 割り込み を 発行 する 。 
3. 必要 に 応じ て 戻り 値 を レジ スタ か ら 取得 する 。 


また 、 BIOS_INLINE マ クロ を 定義 し て C 言 語 プ ログ ラム を コン パイ ル す る と 、 BIOS 
呼び 出し を イン ライ ン 展開 で きま す 。 機能 グル ー プ ご と に イン クル ー ド する ヘッ ダ が 分 か 
れ て いる た め 、 BIOS_INLINE マ クロ の 定義 状態 を 制御 し て 、 特定 の 機能 グル ー プ の 
み イ ン ラ イン 展開 を 行う こと が で きま す 。 


注意 : BIOS_INLINE マ クロ 定義 時 に は ソフ トウ ェ ア 割 り 込み を 直接 利用 する た め 、 ラ イブ ラリ 関数 を 利用 する も 
の と は 異な る プロ グラ ム の 記述 が 必要 と な る 場合 が あり ます 。 例え ば 、 far ポ イン タ を 受け 渡す 際 に 、 DS レ 
ジス タ の 値 を セグ メン ト 値 と し て 利用 する 場合 が ある た め 、 呼び 出し の 前 後 で 適切 に DS レジ スタ の 値 を 設 
定 する 必要 が あり ます 。 


Oi3 ゴ ペ レー ディ ( ソ グ ンス デム 


オペ レー ディ ング シス テバ OS) は 、 BIOS な ど に よっ て 提供 され る 物理 的 な 入出 力 機 
能 を 、 論理 的 な 機能 モジ ュー ル と し て 利用 で きる 高 レ ベル な イン ター フェ イス の サー ビ 
ス を 提供 し ます 。 

WonderWitch 専 用 カー トリ ッ ジ に は 、 FreyaBIOS の 機能 を 用 いて 動作 する オリ ジ 
ナル OS、 FreyaOS」 を 搭載 し て いま す 。 

Frey aOS は 、 次 の 部 分 に 分 けら れ ま す 。 


・ 起動 部 
・ フ ァイル シス テム 
・ プ ロ セ ス 管 理 部 


これ ら の 部 分 の うち 、 こ こ で は 起動 部 に つい て 説明 し ます 。 


10.3.1 FreyaOS の 起動 
FreyaOS は 、 以下 の 流れ に し た が っ て 起動 し ます 。 


1. FreyaBIOS が FreyaOS 起 動 部 を 呼び 出す 。 


2. カー トリ ッ ジ の 状態 を チェ ッ ク し 、 未 初期 化 あ る い は 内 容 が 破壊 され て いる 場合 
に 、 セル フ テ ス ト と 初期 化 を 行う 。 
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3. 初 期 設 定 フ ァイル に し た が い 、 環境 定数 の 設定 と RunnablelL の 起動 を 行う 。 
4. ボタ ン の 押下 状態 を チェ ッ ク し 、 起動 モー ド を 決定 する 。 

・Y1 ボ タン と Y4 ボ タン が 両方 押さ れ て いた ら シ ンプ ルモード 

・ そ れ 以 外 の 場合 は ノー マル モー ド 
5. 起動 モー ド に 応じ て 、 カレ ント ワー キン グ デ イィ レク トリ cwd) と シェ ル を 設定 する 。 


・ シ ンプ ルモード 


cwd ニル ern 
シェ ル ニ テ デフォルト シェ ル Meg) 


・ ノ ー マ ル モー- ド 


cwd 三 /romO 
シェ ル テ ユ ー ザ シェ ル が /rom0/@ shell に あれ ば ユー ザ シ ェ ル 、 そう で な いな ら デ 
フォ ルト シェ ル 


6. シェ ル を 起 生 以降 、 ユ ー ザ 操作 に し た が っ て シェ ル が 動作 ) 


10.3.2 セル フ テ ス ト と 初期 化 

Frey aOS は 、 起動 する 際 に SRA M 上 に 記録 され て いる は ず の 情報 と 、 実際 に 
SRA M 上 に ある 情報 を 比較 し て 、 カー トリッジ 内 の デー タ の 整合 性 を チェ ッ ク し ます 。 も 
し 整合 性 が 崩れ て いる 場合 に は 、 自己 診断 プロ グラ ム の 実 邊 「 623 自己 診断 プロ 
グラ ム の 自動 実行 に つい て 」 参 照 ) と 初期 化 を 行い ます 。 

自己 診断 プロ グラ ム が すべ て 正常 に 終了 し た 場合 に は 、 フ ラッ シュ メモ リ お よび 
SRA M 上 の ファ イル シス テム を 初期 化し ます 。 記録 され て いた 内 容 は BIOS と OS を 除 
きす べ て クリ ア さ れ ま す 。 


10.3.3 初期 設定 ファ イル ( /rom0/init.rc) 

Frey aOS は 起動 時 に 初期 設定 ファ イル を 読み 込み ます 。 この ファ イル に は シス テム 
全体 か ら 利用 され る 値 を 定義 し た り 、 シ ステ ム に 組み 込む イン ダイ レク トラ イブ ラリ を 指 
定 し ます 。 初期 設定 ファ イル は /romO/initrc に 配置 し 、 以下 の 文法 に し た が っ て 記述 
し ます 。 
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書式 : Svarー マ 定義 する 内 容 シ 


シス テム 全体 か ら 参照 可能 な 環境 定数 var を 定義 し ます =" の 次 の 文字 か ら 、 改 
行文 宮 \n) の 直前 まで の 内 容 を 値 最大 64 バ イト ) と し て 設定 し ます 。 ライ ブラ リ 関数 
getenv() を 用 いて 、 特定 の 名 前 の 環境 定数 に 設定 され た 値 を 参照 で きま す 。 


男 RunnablelL 起 動 
書式 : @ililb < 引数 >.…] 


指定 され た 名 前 を 持つ イン ダイ レク トラ イブ ラリ を 検索 し 、 RunnablelL と し て 実行 し 
ます 。 イン ダイ レク トラ イブ ラリ は 、 /romQ、 /kern の 順に 検索 され ます 。 実行 に 失敗 し た 
場合 に は 、 画面 に メッ セー ジ を 表示 し て 一 旦 停止 し 、A ボ タン を 押す と 続行 し ます 。 


10.3.4 ユー ザ シ ェ ル 

初期 化 処理 が 終わ る と 、FreyaOS は 標準 で は デフ ォ ル トシ ェ ル Meg) を 起動 し ま 
す が 、 ユー ザ 独 自 の シェ ル を 利用 する こと も で きま す 。 この よう な シェ ル 寿 ユー ザ シ ェ 
ル 」 と 呼び ます 。 ユー ザ シ ェ ル を 利用 する に は 、 起動 し た い シ ェ ル を 、 /rom0/@shell 
に 配置 し ます 。 


10.3.5 シン プル モー ド で の 起動 

初期 設定 ファ イル を 編集 し た り 、 ユー ザ シ ェ ル を 配置 する と 、 Frey aOS を うま く 起動 
で き な く な る 場合 が あり ます 。 この よう な 場合 の た め に 、 初期 設定 ファ イル の 読み 込み 
と ユー ザ シ ェ ル の 使用 を スキ ッ プ する モー ド が 用 意 さ れ て いま す 。 これ が シン プル モ 
ー ド 」 で す 。 

Y 1 ボタ ン と Y 4 ボタ ン の 両方 を 押し な が ら WonderSwan の 電源 を ON に する と 、 
FreyaOS は シン プル モー ド で 起動 し 、 デ フォ ルト シェ ル が 利用 で きる 状態 と な り ます 。 


10.4 ファ イル シス テム 


Frey aOS は WonderWitch 専 用 カー トリ ッ ジ に 搭載 され た メモ リ の うち 、 フラ ッシュ メ 
モリ 6 バン ク と SRA M 1 バン ク を ファ イル シス テム と し て 扱い ます 。 ファ イル シス テム に よっ て 
情報 を ファ イル と し て アク セス で きま す 。 
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また 、 OS に 組み 込ま れる 特別 な ファ イル シス テム も 存在 し ます 。 


10.4.1 各 フ ァイル シス テム の 概要 
圏 ハー ド フ ァイル シス テム 

フラ ッシュ メモ リ を 用 いた ファ イル シス テム で 、/rom0 デ ィ イレ クト リ と し て アク セス で きま 
す 。 容量 は 全体 で 384KB、 最大 で 128 個 の ファ イル を 格納 する こと が で きま す 。 お も に 
イン ダイ レク トラ イブ ラリ や ユー ザ プ ロ グラ ム を 格納 する た め に 用 いま す 。 この ファ イル シ 
ステ ム に 格納 され て いる ファ イル は 、 mmap0( 関 数 を 用 いて アド レス を 取得 し 、 直接 アク 
セス する こと も で きま す 。 


固 ソ フト ファ イル シス テム 

SRA M を 用 いた ファ イル シス テム で 、 /ram0 デ イレ クト リ と し て アク セス で きま す 。 容量 
は 全体 で 64KB、 最大 で 64 個 の ファ イル を 格納 する こと が で きま す 。 お も に セー ブ デ ー 
タ や ーー 時 的 に 使用 する ファ イル を 格納 する た め に 用 いま す 。 /ram0 に 格納 され た プロ 
グラ ム を 実行 する こと は で きま せん 。 


男 カ ー ネ ル ファ イル シス テム 

OS 内 部 に 組み 込ま れ た ファ イル シス テム で 、 /kern デ イレ クト リ と し て アク セス で きま 
す 。 デフ ォ ル トシ ェ ル や 、 各種 スト リー ム の ドラ イ バ が 格納 され て いま す 。 ユー ザ が ファ 
イル を 追加 する こと は で きま せん 。 


10.4.2 ファ イル エン トリ 
各 フ ァイル に 関す る 情報 は T ファ イル エン トリ 」 に 格納 され 、 OS が 管理 する 領域 に 


憶 さ れ ま す 。 
ファ イル エン トリ は 以下 の よう な 情報 を 保持 し て いま す 。 
項目 内 容 
ファ イル 名 16 バ イト の unsigned char 


“へ 以外 の 文字 列 
た だ し 、 文字 列 中 に " /、“ は 使用 不可 
ファ イル 情報 24 バ イト の unsigned char 
ファ イル の 記録 位置 ファ イル 本 体 が 記録 され て いる アド レス 
floc_《 約 VWitch 当 nclude 湊 ys 当 ypes.h) 


ファ イル の 長 さ ファ イル 本 体 の 長 さ バト 単位 ) 
flen_《 *VWitch 当 nclude 夷 ys 当 ypes.h) 

ブロ ッ ク 数 ファ イル 本 体格 納 用 に 確保 され て いる ブロ ッ パ 128 バ イ 
ト プ ブ ロッ ク ) の 数 
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ファ イル モー ド 16 ビ ッ ト の ビッ ト マッ プ フ ラ グ 
各 ビッ ト の 意味 は 、*VWitch 当 ndude 汐 ys 次 lesys.h で 
定義 
最終 更新 日 時 32 ビ ッ ト の 最終 更新 日 時 
年 : 月 : 日 7:4:5 
時 : 分 : 秒 三 5:6:5 
年 は 2000 年 を 0 と し た 相対 、 秒 は 1/2 し た 値 を 格納 
ファ イル の 種別 ファ イル の 種類 を 表す 32 ビ ッ ト の 値 
リソー スポ イン タ ファ イル 末尾 に 付加 され て いる リソー ス 群 へ の ポイ 
ンタ 
fpos_( 約 VWitch 当 nclude 汐 ys 導 ypes.h) 


10.4.3 空き 容量 と デフ ラグ 

FreyaOS の ファ イル シス テム は 、 ファ イル 削除 に よっ て 解放 され た 領域 を 再 利用 し ま 
せん 。 この た め 、 フ ァイル の 生成 削除 を 繰り 返し て いる と 、 ファ イル シス テム の 空き 容 
量 が 徐々 に 減少 し て いき ます 。 ファ イル の 削除 に より 虫食い 」 状 態 に か っ た ファ イル シ 
ステ ム を 整頓 し て 、 空き 容量 を 確保 する の が デフ ラグ 」 (defragmentation) で す 。 

デフ ラグ は シェ ル 上 か ら 行い ます 。 デフ ォ ル トシ ェ ル Meg) で は 、 フ ァイル 画面 で せ 
いと ん 」 を 実行 し ます 。 この 操作 は ユー ザ プ ロ セス が 起動 し て いる 間 に は 実行 で きま 
せん 。 これ は 、 mmap() 関 数 や イン ダイ レク トラ イブ ラリ の 呼び 出し に よっ て 、 ユー ザ プ ロ 
セス が ファ イル の 実 ア ドレ ス を 参照 する 可能 性 が ある た めで す 。 


10.5 プロ セス 


Frey aOS で は プロ グラ ム 実 行 の 単位 を プロ セス 」 と 呼び ます 。 ユー ザ プ ロ グラ ム 
は も ちろ ん 、 OS 自身 も シス テム 起動 時 に 実行 され る 特別 な プロ セス と し て 管理 され て 
いま す 。 

プロ セス は 、 互い に 独立 し た 記憶 領域 と 実行 状態 を 持ち ます 。 FreyaOS に は プロ 
セス の 実行 状態 を 退避 復元 する 機能 が 用 意 さ れ て いま す 。 実行 状態 を 退避 する 
機能 用 サス ペン ド 」、 退避 され て いる 実行 状態 を 復元 する 機能 リジェ ュー ム 」 と 呼び 
ます 。 

通常 の 方 法 で プロ セス を 実行 する 場合 、 あ と で リ ジ ュ ー ム で きる よう に それ まで に 
実行 中 だ っ た プロ セス を サス ペン ド し ます 。 これ に より 、 プロ セス は 他 の プロ セス の 実 
行状 態 に 影響 を 与え ず に 動作 する こと が で きま す 。 

また 、 サス ペン ド 機能 を 用 いて 電源 を 切る 直前 に 実行 を 中 断 し て 状態 を 退避 し て 
お け ば 、 再び 電源 を 投入 し た と き に 状態 を 復元 し 、 中 断 し て いた と ころ か ら 実行 を 再 
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開 す る こと が で きま す 。 


10.5.1 プロ セス 制御 ブロ ッ ク (PCB) と プロ セス の 属性 

FreyaOS は プロ セス 制御 ブロ ッ PCB: Process Control Block) を 用 いて プロ 
セス の 実行 状態 を 管理 制御 し ます 。 PCB は 各 プ ロ セ ス ご と に 1 つ 確 保 さ れ 、 以下 の 
情報 を 管理 し ます 。 


圏 status 
プロ セス の 現在 の 状態 ロー ド 中 、 実行 中 、 サス ペン ド 中 ) を 表し ます 。 


還 exit code 
プロ セス の 処理 結果 を 表す コー ド で す 。 exit() 関 数 を 用 いて プロ セス を 終了 し た 場 
合 に 設定 され ます 。 


また 、 ユー ザ デ ー タ 領域 の 一 部 を 利用 し て 、 プロ セス に 関す る 以下 の 情報 を 保持 
じ ま す 。 


園 プロ セス ID pid) 

シス テム 起動 か ら 現在 まで に 起動 され た プロ セス の シリ アル ナン バー で す 。 1 以上 の 
正 の 整数 が 順に 割り 当て られ 、 正 の 整数 の 上 限 値 に 達し た 場合 は 、 も う 一 度 1 か ら 数 
え 始 め ま す 。 OS に は 特別 な pid、 0 が 割り 当て られ ます 。 


画 親 プロ セス ID ppid) 
この プロ セス を 起動 し た プロ セ ズ 親 プ ロ セ ス ) の pid で す 。 OS の 場合 は 、 -1 と な り 
ます 。 


園 イン ダイ レク トラ イブ ラリ 操作 Il ilibIL) 
親 プ ロ セ ス か ら 引 き 継 い だ 、 イ ンダ イレ クト ライ ブラ リ 操作 IL で す 。 この IL を 用 いて 、 
イン ダイ レク トラ イブ ラリ の アド レス を 動 的 に 解決 し ます 。 


較 プ ロ セ ス 制 御 I( proclL) 


親 プ ロ セ ス か ら 引 き 継 い だ プ ロ セ ス 制 御 I1L で す 。 この IL を 用 いて 、 プロ セス の 起動 
や サス ペン ド 、 リ ジュ ー ム を 行い ます 。 
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較 カ レン トワ ー キ ング ディ レク トリ 
親 プ ロ セ ス か ら 引 き 継 い だ 相対 パス の 基点 と な る デイ レク トリ で す 。 chdir() ラ イブ ラ 
リ 関 数 を 用 いて 変更 で きま す 。 


10.5.2 プロ セス 起動 の 流れ 
プロ セス は 以下 の 流れ に し た が っ て 起動 し ます 。 


1. PCB 割 り 当て 

プロ セス に PCB を 割り 当て ます 。 PCB に 空き 領域 が な い 場合 に は 、 プロ セス の 起 
動 は 失敗 し ます 。 ユー ザ プ ロ セス 用 に 2 つ 、 OS 用 に 1 つ 、 あ わせ て 3 つ 確 保 さ れ て い 
ます 。 


2. 初期 化 済 み デ ー タ の ロー ド 
ユー ザ プ ロ セス 用 デー タ 領 域 容量 64MKB) に 、 プロ グラ ム フ ァ イル か ら 初期 化 済み 
デー タ を 転送 ロー ド ) し ます 。 実際 に 転送 を 行う の は 、 スタ ー ト アッ プル ー チ ン で す 。 


3. 親 プ ロ セ ス 環 境 の 引継 ぎ 
親 プロ セス が 使用 し て いる イン タイ レク トラ イブ ラリ 群 、 カレ ント ワー キン グ デ イレ クト リ 
を 引き 継ぎ ます 。 


4. コマ ンド ライ ン パラ メー タ の 設定 

ユー ザ プ ロ セス 用 デー タ 領 域 の 空き 部 分 に コマ ンド ライ ン パ ラメ ー タ を 設定 し ます 。 

5. ヒー プ 領 域 の 設定 

最終 的 に 残っ た ユー ザ デ ー タ 領域 の 先頭 ドレ ス を ヒー プ 領 域 の 先頭 アド レス と し 
て 、_heap 変 数 \WWitch\include\process.h で 定義 ) に 格納 し ます 。 


6. main 関 数 の 呼び 出し 
スタ ー ト アッ プル ー チ ン を 経由 し て 、 main( 関 数 を 呼び 出し ます 。 


006 イン タイ レク トラ イラ ラリ 


FreyaOS で は 実行 時 に 動 的 に 結合 し て 機能 を 呼び 出す こと の で きる ライ ブラ リ 形 
態 を 提供 し て いま す 。 これ が イン ダイ レク トラ イブ ラリ 」 で す 。 イン ダイ レク トラ イブ ラリ は 、 
その 名 の 通り 、 間接 的 に 機能 を 呼び 出す こと の で きる 関数 ライ ブラ リ で 、 以下 の 特徴 
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を 持ち ます 。 


・ 実行 時 に 動 的 に 関数 の アド レス を 解決 する 、 遅延 束縛 Late Binding) 

・ 機能 セッ ト を まとめ て 定義 し た 構造 集 IL 構造 体 ) を 通じ て の 関数 呼び 出し 
・ イ ンダ イレ クト ライ ブラ リフ ァイル の 入れ 換え に よる 、 機能 拡張 

・ 名 前 ファ イル 名 ) に し た が っ た ライ ブラ リ の 検索 


これ を 利用 し て 、 次 の よう な こと が 実現 で きま す 。 
・ 複 数 の プロ グラ ム で 利用 され る ライ ブラ リ 関数 が 重複 し て リン ク さ れる こと を 防 
ぐら 


・ 大 き な プ ログ ラム を 小さ な 単位 に 分 割 する 。 


イン ダイ レク トラ イブ ラリ の 具体 的 な 利用 方 法 は 、 第 9 章 チ ュー トリ アル 9.9 ユー ザ 
IL の 実装 と 利用 」 で 取り 上 げ て いま す の で 、 そちら を 参照 し て くだ さい 。 


10.6.1 標準 イン ダイ レク ト ライ ブラ リ 
FreyaOS で は 多く の プロ セス が 共通 し て 利用 する 機能 を OS 内 蔵 の 標準 イン ダイ レ 
クト ライ ブラ リ と し て 提供 し て いま す 。 


画 |libIL 

イン ダイ レク トラ イブ ラリ の 検索 、 アド レス 解決 を 行う IL で す 。 ユー ザ プ ロ グラ ム か ら 
は 通常 山 blL を 通じ て 参照 で きま す 。 /rom0/@ilibp フ ァイル を 配置 し て 、 OS を 再起 動 す 
る こと に より 、 ユー ザ 定 義 の IliblL を 利用 可能 で す 。 


圏 ProclL 

プロ セス の 起動 、 終了 、 サス ペン ド 、 リ ジュ ー ム を 制御 する 1L で す 。 ユー ザ プ ロ グラ 
ム か ら は 、 通常 proclL マ クロ と 通じ て 参照 で きま す 。/rom0/@proc フ ァイル を 配置 し 
て 、 OS を 再起 動 す る こと に より 、 ユー ザ 定 義 の ProclL を 利用 可能 で す 。 


画 FsIL 

記録 領域 記憶 媒体 に 応じ て 、 ファ イル シス テム に 関連 する 種々 の 機能 を 提供 する 
IL で す 。 ファ イル 関連 の ライ ブラ リ 関数 open0、 close0、 read0、 write0 な ど ) が 、 内 部 
的 に 使用 する も の で 、 ユー ザ プ ロ グラ ム が 直接 使用 する こと は あり ませ ん 。 各種 ファ 
イル シス テム に 対応 し た も の が 内 蔵 さ れ て いま す 。 
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園 StreamlL 

ファ イル 操作 を 通じ て アク セス され る 、 スト リー ム デ バイ ス の 機能 を 提供 する IL で す 。 
FsIL 群 が 内 部 的 に 使用 する も の で 、 ユー ザ プ ロ グラ ム が 直接 使用 する こと は あり ませ 
ん 。 各種 ファ イル シス テム 、 通信 回 線 、 仮想 キー ボー ド 、 仮想 コン ソー ル 用 の も の が 内 
蔵 さ れ て いま す 。 


注意 : 仮想 キー ボー ド 、 仮想 コン ソー ル 用 の も の は 現 バ ー ジ ョ ン で は 実装 され て いま せん 。 


圏 RunnablelL 
通常 の プロ セス と 同じ イン ター フェ イス を 持ち 、 ある 種 の ライ ト ウェ イト プロ セス 的 に 
利用 され る IL で す 。 シェ ル は RunnablelL と し て 実装 し ます 。 
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リポ CPM 


WonderSwan 本 体 に は 、 Intel 80186 と バイ ナリ 互換 性 の ある 16 ビ ピット CPU が 搭載 さ 
れ て いま す 。 80186 バ イナ リ 互換 な が ら 、 次 の よう な 特徴 を 持つ 高 性 能 な CPU で 、 
3072MHz ク ロッ ク で 動作 し て いま す 。 


・1 ク ロッ ク 1 バス サイ クル の 実現 に よる 高い バス 効率 

・ 内 部 パイ プラ イン 化 に よる 高速 な 命令 実行 

・CMOS ス タテ ィ ッ ク 設計 に より 内 部 シス テム クロ ッ ク の 完全 停止 を 実現 
・20 ビ ッ ト ア ドレ スバ ス 、16 ビ ッ ト デー タバ ズ 入力 / 出 力 分 離 バス ) 


11.2 メモ リ 


WonderWitch は 3 種類 の メモ リ を 搭載 し て お り 、 用 途 に 応じ て 使い 分 け て いま す 。 


固 フ ラッ シュ メモ リ 

WonderWitch 専 用 カー トリ ッ ジ 上 に 、 512KB 搭 載 さ れ て いま す 。64KB は 電気 的 に 
ライ ト プ ロ テク ト さ れ て お り 、 書き 換え る こと が で きま せん 。 書き 換え 可能 な 領域 の う 
ち 、 64KB に オペ レー ティ ング シス テム が 格納 され 、 残り の 384KB が ハー ド ファ イル シ 
ステ ム と し て 利用 され ます 。 電源 OFF で も 内 容 が 保存 され ます 。 


固 SRAM 
WonderWitch 専 用 カー トリ ッ ジ 上 に 、 256KB 搭 載 さ れ て いま す 。 64KB ず つ 、 4 つの 
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バン ク に 分 か れ て いま す 。 4 つの バン ク は 以下 の よう に 利用 され ます 。 


・ オ ペレ ー テ ィング シス テム 用 ワー クエ リア 
・ ユ ー ザ プロ セス 用 デー タ エ リ ア X 2 
・ ソ フト ファ イル シス テム 


電池 パッ クア ッ プ に より 、 電源 OFF で も 内 容 が 保持 され ます 。 


男 本 体内 蔵 RAM 

WonderSwan 本 体 に 、 16KB 搭 載 さ れ て いま す 。 オペ レー ティ ング シス テム の ワー ク 
エリ ア 、 ユー ザ プ ロ グラ ム の スタ ッ ク と し て 利用 され ます 。 本 体 の 電源 を 切る と 、 内 容 
は 破壊 され ます が 、 サス ペン ド プレ ジュ ー ム 機能 を 用 いて 、 実行 状態 を 保存 復元 
する こと が で きま ず 「 105 プロ セス 」 参 照 )。 


11.3 画面 


WonderWitch の 画面 を 構成 する 要素 に は 、 以下 の も の が あり 、 こ れ ら の 機能 を 組 
合わ せ て 画面 表示 を 行い ます 。 


・LCD パ ネル 
・LCD カ ラー マッ プ 

・ キ ャ ラク タカ ラー パレ ッ ト 
・ キ ャ ラク タフ ォ ン ト 

・ ス クリ ー ン 

・ ス プラ イト 


中層 1 上 GDIMSGLCD9 ラ ー マ ッ プ 

LCD パ ネル は 、 224X 14 ボ ポット の 大 き さ を 持つ ドッ トマ トリ クス 表示 部 分 と 、 各種 マー 
ク を 表示 する セグ メント 部 分 か ら な り ま す 。 

ドッ トマ トリ クス 表示 部 分 は 16 砂 調 の 表現 力 を 持っ て いま す が 、 同時 に 表示 で きる 
の は この うち の 8 脂 調 の み で す 。 
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LCD カ ラー マッ プ 山 | 圏 | | 


キャ ラク タ 図 
カラ ー パ レッ ト 群 較 


LCD カ ラー マッ プ に 、 0 か ら 7 の 各 LCD カ ラー 番号 に 対応 する 階 調 を 16 上 調 の な か 
か ら そ れ ぞ れ 指 定 し て 、 同時 に 表示 する 8 階 調 を 選択 し ます 。 

LCD カ ラー マッ プ の 設定 を 変更 する と 画面 全体 に 影響 び が あ る た め 、 フ ェ ー ド イン 、 フ 
ェ エー ドア ウト な どの 効果 を 得る 場合 な ど に 、 こ の 機能 を 用 いる こと が で きま す 。 

セグ メン ト 部 は 、 WonderSwan 本 体 を 横向 き に 持っ た 場合 に LCD パ ネル 下部 に 配 
置 さ れ て いる 、 電池 マー ク 、 音量 マー ク 、 ヘッ ド フォ ンマ ー ク な どの 各種 マー ク 群 で す 。 
LCD カ ラー マッ プ の 設定 に よら ず 、 点灯 また は 消灯 の いずれ か の 状態 を 各 マ ー ク ご と 
に 設定 し ます 。 


11 83 2 キャラクタ 
WonderSwan の 画面 表示 は 、 キャ ラク タ と 呼ば れる 8X ボッ ト の グラ フィ ッ ク デ ー タ 


を 1 つの 単位 と し て 行い ます 。 キャ ラク タ は 、 キャ ラク タフ ォ ン ト と キャ ラク タカ ラー パレ ッ 
ト の 組み 合わ せ で 表現 し ます 。 


キャ ラク タフ ォ ン ト は 、 最大 512 種 類 定 義 可 能 で 0 か ら 511 の 番号 で 特定 され ます 。1 
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キャ ラク タフ ォ ン ト 内 で 使用 可能 な 色 は 4 色 で す 。 ド ッ ト ご と の 色 を 2 ビット の 番号 で 指定 
し 、1 キ ャ ラク タフ ォ ン ト に つき 、16 バ イト で グラ フィ ッ ク デ ー タ が 表現 され ます 。 

キャ ラク タフ ォ ン ト で 指定 し た 各 ド ッ ト の 色 番号 を 、 LCD カ ラー マッ プ の 8 色 に 対応 付 
ける の が キャ ラク タカ ラー パレット で す 。 キャ ラク タカ ラー パレット は LCD カ ラー マッ プ の 
8 色 中 、 4 色 を 選択 し て キャ ラク タフ ォ ン ト の 色 番 号 に 対応 付け ます 。 

キャ ラク タカ ラー パレ ッ ト は 全部 で 16 個 あり 、 そ れ ぞ れ 独 立 に LCD カ ラー を 割り 当て 
る こと が で きま す 。 し た が っ て 、 同じ キャ ラク タフ ォ ン ト を 用 いて も 、 組み 合わ せる キャ ラ 
クタ カラ ー パレ ッ ト が 異な れ ば 、 画面 に 実際 に 表示 され る 内 容 は 異な り ま す 。 


11.3.3 スク リー ン 
シュ ー デ ィング ゲー ム の 背景 や ロー ルプ レイ ング ゲー ム の マッ プ な ど 、 画面 全体 を 覆っ 
て 、 あま り 細か な 動き を 必要 と し な い グ ラフ ィ ッ ク は 、 スク リー ン を 用 いて 表示 し ます 。 
スク リー ン は 、 キャ ラク タ を 縦横 32X 32 ず つ 、 全部 で 1024 個 な ら べた 256x 25 ボ ッ ト 
の 広 さ を 持つ 仮想 的 な 画面 で 、 スク リー ン 1] と スク リー ン 2 の 2 面 が あり ます 。 


年 キラ ウタ 図 、 32char 


ーー:eu3zge = プ 


スク リー ン 較 


スク リー ン 1、 スク リー ン 2 の 1024 個 の キャ ラク タ す べ て に つい て 、 以下 の 情報 を それ 
ぞ れ 設定 し ます 。 


・ キ ャ ラク タフ ォ ン ト 

・ キ ャ ラク タカ ラー パレ ッ ト 
・ 縦 反転 表示 

・ 横 反転 表示 


また 、 ハー ド ウェ アス クロ ー ル 機能 に より 、 スク リー ン 1、 スク リー ン 2 それ ぞ れ に つい 
て 、 ドッ ト 単位 で LCD パ ネル 上 に 実際 に 表示 され る 範囲 を 設定 で きま す 。 

スク リー ン 2 は 、 必ず スク リー ン 1 より 手前 に 表示 され ます 。 し た が っ て 、 スク リー ン 2 
上 に 不透明 な グラ フィ ッ ク が ある と 、 その 部 分 の スク リー ン 1 の グラ フィ ッ ク は スク リー ン 
2 に 隠れ て 、 画面 上 で は 見 えな く な り ま す 。 
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スク リー ン 1 


内 側が 透明 較 


|] 


ウィ ンド ウ 較 外側 が 透明 図 


また 、 スク リー ン 2 に は 、 ウィ ンド ウ 機 能 も 搭載 され て いま す 。 ウィ ンド ツウ 機能 と は 、 指 
定 し た 乱 形 領域 の 内 側 ま た は 外側 の いずれ か の み を 表示 する 機能 で す 。 表示 範囲 
外 は 透明 で ある も の と し て 扱わ れる の で 、 スク リー ン 2 より も 奥 に ある グラ フィ ッ ク が 表 
示さ れ ま す 。 

例え ば 、 スク リー ン 2 に 部 屋 の 中 の 様子 と 窓 を 描い て 、 窓 以外 の 部 分 を 表示 する 
よう に ウィ ンド ウ 機 能 を 設定 し た 上 で スク リー ン 1 と 重ね て 表示 すれ ば 、 窓 か ら 外 の 風 
景 が 見 える よう な 効果 を 得る こと が で きま す 。 


11.3.4 スプ ライ ト 
ゲー ム な ど に お ける 自 キ ャ ラク タ や ミサ イル 、 ボー ル な ど 、 画面 上 を 動き 回 る グラ フィ 
ッ ク は スプ ライ ト を 用 いて 表示 し ます 。 


スプ ライ ト 1 つ は 、 キャ ラク タフ ォ ン ト 1 個 分 の 大 き さ で 、 キャ ラク タフ ォ ン ト と キャ ラク タカ 
ラー パレ ッ ト 、 お よび ドッ ト 単位 で 画面 上 の 表示 位置 を 指定 し ます 。 大 き な グ ラフ ィ ッ 
ク を まとめ て 動かす 際 に も 、 キャ ラク タ 単 位 に 分 解 し て 、 そ れ ぞ れ の 表示 位置 を 制御 
する 必要 が あり ます 。 スプ ライ ト で 利用 可能 な キャ ラク タカ ラー パレ ッ ト は 、16 個 の うち 
番号 の 大 きい 8 個 の み で す 。 

スプ ライ ト は 最大 128 個 表示 する こと が で きま す が 、 1 水平 ライ ン 上 に は 同時 に 32 個 
まで し か 表示 で きま せん 。 

スプ ライ ト 同士 が 重なっ た 場合 に は 、 番号 の 小さ いも の が 手前 に 表示 され ます 。 ス 
クリ ー ン 1 に 対し て は 、 す べ て の スプ ライ ト が 手前 に 表示 され ます 。 スク リー ン 2 に 対し 
て は 、 各 ス プラ イト ご と に 優先 度 を 指定 し 、 手前 、 あ る い は 奥 に 表示 する こと が で きま 
す 。 

さら に 、 スク リー ン 生 同様 の ウィ ンド ウ 機 能 が 利用 で きま す 。 ウィ ンド ウ の 内 側 と 外側 
の どちら で 表示 を 行う か を 各 ス プラ イト キャ ラク タ ご と に 設定 し ます 。 
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11.3.5 キャ ラク タ の 反転 表示 

スク リー ン 上 の キャ ラク タ 、 スプ ライ ト と も に 、 キャ ラク タフ ォ ン ト を 表示 する 際 に 縦横 そ 
れ ぞ れ に つい て 反転 表示 を 指定 で きま す 。 縦横 反転 表示 を 用 いる と 、 1 つの キャ ラク 
タフ ォ ン ト デー タ を さま ざま な 向き で 表示 する こと が で きま す 。 


フォ ント データ 罰 


和民 NNE 


11.4 キー 


WonderSwan 本 体 上 に 配置 され て いる X、Y、A、 B、 お よび START の 各 ボ タン の 
押下 状態 を 得る こと が で きま す 。 

ハー ド ウェ アア ー キ テク チャ 上 、 こ れ ら の ボタ ン は X 群 、Y 群 、 そ の 他 の 3 つの グル ー 
プ に 分 か れ て お り 、 厳密 に いう と 同時 に 押下 状態 を 得る こと が で きる の は どれ か 1 つ 
の グル ー プ の み で す 。 

WonderWitch で は 、 VBLA NK タ イマ 割り 込み を 利用 し て 順に 各 グ ルー プ の 押下 
状態 を スキ ャ ン し 、 内 部 の ワー クエ リア に 保持 し て いま す 。 また 、 前 回 スキ ャ ン し た 押下 
状態 を 利用 し て 、 オー トリ ピー ト が か か る よう に な っ て いま す 。 

キーBIOS の 各 機能 は 内 部 の ワー クエ リア に 保持 し て いる 値 を 返し ます 。 キーBIOS 
を 通じ て 押下 状態 が 得 ら れる 、 ソ フト ウェ ア 的 に と ら え た 各 ボ タン の こと キー」 と 呼 
び ま す 。 


注意 SOUND ボ タン の 状態 を 得る こと は で きま せん 。 


11.5 通信 


WonderSwan 本 体 に 搭載 され て いる 全 二 重 通 信 対 応 、 調歩 同期 式 の シリ アル ポ 
ー ト を 利用 し 、 外部 に 接続 され た 機器 や 他 の WonderSwan と 通信 し ます 。 


77 


第 2 部 デベ ロッ パーズ マニ ュ ア ル 


シリ アル ボー ト の 詳細 な 仕様 は 以下 の 通り で す 。 


項目 仕様 

プロ トコ ル デー タリ ンク 下層 ) 調歩 同期 、 全 二 重 通信 
ボー レ - ト 9600bps/38400bps 切 り 替え 
デー タビ ッ ト 数 8 ビッ ト 固定 、 パ リティ ー な し 
送信 スト ッ プ ビッ ト 長 1 ビッ ト 

送信 バッ ファ な し 

受信 バッ ファ 1 段 

エラ ー 検 出 受信 オー バー ラン 

モデ ム 制 御 信号 な し 


11.6 音源 


WonderSwan 本 体 に は 、 4 チャ ン ネ ル の PCM 音源 が 搭載 され て いま す 。 各 チャ ン ネ 
ル は 、 波形 デー タ と 左右 独立 の 音量 デー タ と の 符号 な し 乗算 を 行っ て 、 左右 それ ぞ れ 
の 音声 デー タ を 生成 し ます 。 左右 それ ぞ れ の 出力 は 、 全 チ ャ ン ネ ル 分 の 出力 デー タ 
を 加算 し た 結果 と な り ま す 。 

最終 的 な 出力 は 、 WonderSwan 本 体 に 搭載 され て いる 圧電 スピ ー カ ー PWM 方 
式 ) へ の モノ ラル 出力 、 また は 、 周辺 機器 差し 込み 口 に 接続 され た ヘッ ド フ ォ ン へ の ス 
テレ オ 出 力 と な り ま す 。 ステ レオ 出力 の 場合 に は 、 全 チ ャ ン ネ ル 分 合成 され た 左右 の 
出力 が 直接 送ら れ ま す 。 モノ ラル 出力 の 場合 に は 、 左右 チャ ン ネ ル の 出力 が 合成 さ 
れ 、 さ ら に 、 スケ ー リ ング し て オー バー フロ ー し な いよ うに し た 結果 が PWM エン コー ド 
され て 送ら れ ま す 。 

波形 デー タ は 4 ビット x 32 ス テッ プ 、16 バ イト の デー タ で 表し 、 チャ ン ネ ル ご と に 別 な 
波形 を 設定 で きま す 。 

チャ ン ネ ル 1 以外 の 3 つの チャ ン ネ ル は 、 上 記 の 基本 音源 機能 以外 に 、 そ れ ぞ れ 個 
別 の 付加 機能 を 持っ て いま す 。 

チャ ン ネ ル 付加 機能 機能 の 説明 

チャ ン ネ ル 1 ( なし) 一 

チャ ン ネ ル 2 ボイス 8 ジット の サン プリ ング デー タ を 直接 出力 する 切り 替え ) 

チャ ン ネ ル 3 スウィープ 周波 数 を 時 間 と と も に 一 定 の 割合 で 変化 させ る 

チャ ン ネ ル 4 ノイ ズ 8 種類 の 中 か ら 選択 し た タイ プ の ノイ ズ を 発生 させ る 

( 切り 替え ) 


11.7 割り 込み 


割り 込み と は 、 ハー ド ウェ ア の 要求 に し た が っ て 、 緊急 性 の ある 処理 を 行っ た り 定 期 
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ハー ド ウェ アア ー キ テク チャ 


的 に 処理 を 実行 する た め に 用 いる 機能 で す 。 また 、 プロ グラ ム が 関数 呼び 出し の か 
わり と し て 利用 する 場合 あり ます 。 前 者 の よう な 割り 込み を ハー ド ウェ ア 割 り 込み 、 後 
者 の よう な 割り 込み を ソフ トウ ェ ア 割 り 込 み と 呼び ます 。 

WonderWitch で は 、 周辺 ハー ド ウェ ア と の や り 取 り に ハー ド ウェ ア 割 り 込 み を 利用 
し 、 BIOS 機 能 の 呼び 出し に ソフ トウ ェ ア 割 り 込 み を 利用 し ます 。 

ハー ド ウェ ア 割 り 込 み に は 、 8 種類 の も の が あり ます 。 各 割 り 込み の 割り 込み ベク タ 
は 、 Ox28 に エン コー ド の 値 を 加え た も の で す 。 


エン コー- ド 割り 込み 要因 トリ ガタ イプ 優先 順位 
7 水平 同 工 HBLANK) エッ ジ 最高 
タイ マカ ウン ト 終了 A 
6 垂直 同 項 VBLANK) エッ ジ 
期間 開始 
5 垂直 同 項 VBLANK) エッ ジ 
タイ マカ ウン ト 終了 
4 描画 ライ ン 番号 検出 エッ ジ 
3 シリ アル 受信 デー タレ ディ ー レベ ル 
2 RTC ア ラー ム レベ ル 
( カセ ッ ト か ら の 割り 込み ) 
1 キー 押下 検出 エッ ジ 
0 シリ アル 送信 デー タ レベ ル 最低 
エン プティ 


ソフ トウ ェ ア 割 り 込 み は 、 BIOS 機 能 の 呼び 出し に 用 いら れ ま す 。 BIOS 機 能 は カテ 
ゴリ ご と に 分 類 さ れ 、 そ れ ぞ れ 割 り 込 み ベ クタ が 1 つづ つ 割 り 当て られ て いま す 。 割り 
込み ベク タ 番 号 と 機能 カテ ゴリ の 対応 は 以下 の 通り で す 。 


ベク タ 番 号 機能 カテ ゴリ 
Ox10 プロ グラ ム 終 了 
0x11 キー 

0x12 画面 制御 

0x13 テキ スト 画面 
0x14 シリ アル 通信 制御 
0x15 サウ ンド 

Ox16 タイ マカ レン ダ 
0x17 シス テム 制御 
Ox18 バン ク 制 御 


各 機 能 カ テ ゴ リ の 詳細 に つい て は J 付録 B FreyaBIOS 仕 様 」 を 参照 し て くだ さい 。 
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付録 A 


FreyaOS 標準 ライ ブラ リ 仕様 


A.1 stdio 
A.1.1 概要 
ファ イル 入出 力 を 行う た め の 機 能 群 で す 。 
項目 内 容 
ヘッ ダー ファ イル stdio.h 
多重 include 回 避 用 マク ロ _STDIO_H_ 
ライ ブラ リフ ァイル libww.lib 


A.1.2 関数 プ マ クロ 


・int num_iob() 


プロ グラ ム が 利用 する FILE 構 造 体 の 配列 の サイ ズ を 返す 関数 で す 。 ユー ザ プ ロ グラ ム で 定義 
する こと で 、 最大 同時 オー プン 可能 な ファ イル 数 を 設定 で きま す 。 この 場合 に は 、_iob も 同時 に 定 
義 す る 必要 が あり まず 「 A.1.3 定数 変数 」 の 項 _iob」 参 照 )。 


・FILE far * fopen(const char far *※ fname, const char far *※ mode): 


ファ イル を オー プン し ます 。 成功 し た 場合 に は 、 FILE 構 造 体 へ の far ポ イン タ が 返り 、 失敗 し た 
場合 に は 、 NULL を 返し ます 。 fname に は オー プン する ファ イル の パス 名 を 指定 し ます 。 mode に 
は オー プン する モー ド を あら わす 文字 列 を 、 以下 の いずれ か で 指定 し ます 。 


な 。 リー ド オ シリ ー モ ー ド 
wi ライ 人 ト オ ン リー モー ド 
a: アペンド モー ド 


fopen0( で オー プン し た ファ イル は 、 必要 な く な っ た 時 点 で fclose0 で クロ ー ズ し ます 。 同時 に オ 
ー プ ン 可能 な 最大 ファ イル 数 は 、 num_iob(0 で 得る こと が で きま す 。 


・FILE far * freopen(const char far *※ fname, const char far ※ mode, FILE far※fD): 
指定 し た FILE 構 造 体 月 いて ファ イル を オー プン し ます 。 成功 し た 場合 に は 、 FILE 構 造 体 へ 
の far ポ イン タ を 返し 、 失敗 し た 場合 に は 、 NULL を 返し ます 。 指定 し た FILE 構 造 体 が オー プン 


中 の 場合 に は 、 ま ず ク ロー ズ し て か ら 新 し い フ ァイル を オー プン し ます 。 その 他 の 引数 に つい て は 
fopen0 と 同様 で す 。 
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・int flush(FILE far*※ fp): 


き 込 み パ バッ ファ を フラ ッシュ し ます 。 ファ イル が ライ ト オー プン され て いな い 場合 に は 、 -1 を 返し 


州 
周 下 


・int fclose(FILE far * fp): 


ファ イル を クロ ー ズ し ます 。 ファ イル が オー プン され て いな い 場合 に は 、 -1 を 返し ます 。 ファ イル が 
ライ ト オー プン され て いる 場合 に は 、 実際 に クロ ー ズ する 前 に flush( ) を 呼び ます 。 


・int fprintf(FILE far *※ fp, const char far *※ format .…): 
int vfprintf(FILE far * fp, const char far ※ formatva_Lis1: 


書式 に し た が っ た ファ イル 出力 を 行い ます 。 正常 に 出力 が 行わ れ た 場合 に は 、 実際 に 出力 し 
た バイ ト 数 を 返し ます 。 何ら か の エラ ー が 生じ た 場合 に は 、 -1 を 返し ます 。 format に 指定 する 書 
式 に つい て は J printf の 書式 」 の 項 を 参照 し て くだ さい 。 


リロ 


・int printf(const char far * format .…): 
int vprintf(const char far *※ format va_lis1: 


標準 出力 に 対し て 、 書式 に し た が っ た 出力 を 行い ます 。 正常 に 出力 が 行わ れ た 場合 に は 、 実 
際 に 出力 し た バイ ト 数 を 返し ます 。 何 ら か の エラ ー が 生じ た 場合 に は 、 -1 を 返し ます 。 format に 
指定 する 書式 に つい て は J printf の 書式 」 の 項 を 参照 し て くだ さい 。 


・int sprintf(char far * buf const char far *※ format .…): 
int vsprintf(char far * buf const char far *※ format va_list: 


昌 定 し た 文字 列 格納 バッ ファ に 対し て 、 書式 に し た が っ た 出力 を 行い ます 。 正常 に 出力 が 行 
われ た 場合 に は 、 実際 に 出力 し た バト 数 を 返し ます 。 何ら か の エラ ー が 生じ た 場合 に は 、 -1 を 
返し ます 。 format に 指定 する 書式 に つい て は J printf の 書式 」 の 項 を 参照 し て くだ さい 。 


・int fgetc(FILE far * fp): 
#Jefine getc fgetc 
#Jefine getchar() getc(stdin) 


ファ イル (標準 入力 ) か ら 1 バト 読み 込み ます 。 正常 に 入力 され た 場合 に は 、 読み 込ま れ た デー 
タ を 返し ます 。 ファ イル 終端 に 達し て いる 場合 に は EOF を 返し ます 。 


・char far * fgets(char far * buf int len, FILE far*※fD): 
ファ イル か > ら 1 行 分 、 文字 列 を 読み 込み ます 。 改行 文字 まで 、 最大 len バ イト の デー タ を 読み 込み 


ます 。 gets( と 異な り 、 行末 の \n" は 削除 し ませ ん 。 正常 に 入力 され た 場合 に は 、 読み 込ま れ た 
バイ 列 へ の far ポ イン タ を 返し ます 。 何ら か の エラ ー が 発生 し た 場合 に は 、 NULL を 返し ます 。 
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・char far * gets(char far *※ buf): 


標準 入力 か ら 1 行 分 、 文字 列 を 読み 込み ます 。 改行 文字 が 現れ る か 、 フ ァイル 終端 に 達する ま 
で 、 デー タ を 読み 込み ます 。 行末 の ' \n" は 削除 され ます 。 正常 に 入力 され た 場合 に は 、 読み 込 
まれ た バイ ト 列 へ の far ポ イン タ を 返し ます 。 何 ら か の エラ ー が 発生 し た 場合 に は 、NULL を 返し 
ます 。 


・int fputc(char ch, FILE far * fp): 
#define putc fputc 
#Jefine putchar(c) putc(c, stdout) 


ファ イル 標準 出力 ) に 1 バト 書き 出し ます 。 正常 に 出力 され た 場合 に は 、 書き 出し た デー タ が 
返り ます 。 何 ら か の エラ ー が 発生 し た 場合 に は 、EOF を 返し ます 。 


・int fputs(const char far * string, FILE far * fp): 


ファ イル に 文字 列 を 書き 出し ます 。 正常 に 出力 され た 場合 に は 、 正 の 数 値 を 返し ます 。 何 ら か 
の エラ ー が 発生 し た 場合 に は 、EOF を 返し ます 。 


・int puts(const char far ※* string): 


標準 出力 に 文字 列 を 書き 出し ます 。 正常 に 出力 され た 場合 に は 、 正 の 数 値 を 返し ます 。 何 ら 
か の エラ ー が 発生 し た 場合 に は 、EOF を 返し ます 。 


・int ungetc(char ch, FILE far * fp): 


ファ イル か ら 読み 込ん だ デー タ を 1 バト 書き 戻し ます 。 シス テム が 保証 する 書き 戻し 可能 バイ ト 
数 は 1 バイ ト の み で す が 、 setvbuf0、 setbuf0 を 用 いて 、 独自 の パッ ファ を 設定 する こと が で きま す 。 


・size_t fread(void far *※ buf size_tsize, size_tnobj, FILE far※fD): 


ファ イル か ら ブ ロッ ク デ ー タ を 読み 込み ます 。 size バ イト の デー タ を 最大 nobj 個 、 buf に 読み 込み 
ます 。 正常 に 読み 込ま れ た デー タ の 個数 を 返し ます 。 実行 後 の フ ァイル の 状態 は 、 feof0、 ferror( 
を 使っ て 調べ ます 。 


・size_tfwrite(const void far * buf size_t size, size_tnobj, FILE far * fp): 


ファ イル に ブロ ッ ク デ ー タ を 書き 出し ます 。 size バ イト の デー タ を 最大 nobj 個 、 buf か ら 書き 出し 
ます 。 正常 に 書き 出さ れ た デー タ の 個数 を 返し ます 。 ファ イル 出力 に 対す る パッ ファ リン グ 機 能 が 
ある の で 、 実際 に ファ イル に 書き 出す た め に は 、 fflush(0 を 呼ぶ 必要 が ある 場合 が あり ます 。 実行 
後 の フ ァイル の 状態 は 、 feof0、 ferror0 を 使っ て 調べ ます 。 


・int fseek(FILE far * fp, long offset int origin): 


ファ イル ポジ ショ ン 読み 書き を 行う 位置 ) を 設定 し ます 。offset に 移動 量 を 指定 し 、 origin に 位 
置 指 定 の 起点 と な る 場所 を 、 次 の いずれ か で 指定 し ます 。 
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SEEK_SET: ファ イル 先頭 
SEEK_CUR: ファ イル ポイ ンタ の 現在 位置 
SEEK_END: ファ イル 未 尾 


正常 に 実行 され た 場合 に は 0 を 、 エラ ー が 発生 し た 場合 に は それ 以外 の 値 を 返し ます 。 


・long ftell(FILE far*※fp): 


現在 の ファ イル ポジ ショ ン (読み 書き を 行う 位置 ) を た 取得 し ます 。 エラ ー が 発生 し た 場合 に は 、 -1L 
を 返し ます 。 


・void rewind(FILE far * fp): 


ファ イル ポイ ンタ を ファ イル 先頭 に 戻し 、 エラ ー を クリ ア し ます 。 fseek(fp, 0 SEEK_SET )、 
clearerr(fp) を 行う の と 同様 で す 。 


・int fgetpos(FILE far * fp, fpos_t far *※ Dos): 
現在 の ファ イル ポイ ンタ の 位置 を pos で 指定 する バッ ファ に 記録 し ます 。 記録 し た 位置 は 、 


fsetpos( ) を 用 いて あと で 再 設定 する こと が で きま す 。 エラ ー が 発生 し た 場合 に は 、 O 以 外 の 値 を 返 
し ます 。 


・int fsetpos(FILE far *※ fp, const fpos_t far * pos): 


fgetpos0 で 記録 し た ファ イル ポイ ンタ の 位置 を 再 設定 し ます 。 エラ ー が 発生 し た 場合 に は 、 O 以 
外 の 値 を 返し ます 。 


・void perror(const char far * string): 


errono に 保持 され て いる 最新 の エラ ー 情 報 に し た が っ て 、 標準 エラ ー 出 力 に エラ ー メ ッ セ ー ジ 
を 出力 し ます 。 


・int setvbuf(FILE far * fp, char far * buf int mode, size_t len): 
void setbuf(FILE far *※ fp, char far *※ buf): 


入出 力 用 の パッ ファ を 設定 し ます 。 ファ イル を オー プン し た あと 、 実際 に 読み 書き を 行う 前 に 呼 
ぶ 必 要 が あり ます 。 


・clearerr(fp) マ クロ 

ファ イル の エラ ー お よび EOF フ ラグ を クリ ア し ます 。 

・feof(fp) マ クロ 

ファ イル 終端 EOF ) に 達し た か どう か を 検査 し ます 。 ファ イル 終端 に 達し て いる 場合 に は 、 0 以 


外 の 値 を 返し ます 。 
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・ferror(fp) マ クロ 


ファ イル に エラ ー が 発生 し て いる か どう か を 検査 し ます 。 エラ ー が 発生 し て いる 場合 に は 、 O 以 
外 の 値 を 返し ます 。 


・FILE far * tmpfile(void): 


作業 用 の 一 時 ファ イル を ライ ト オー プン し 、 FILE 構 造 体 へ の far ポ イン タ を 返し ます 。 エラ ー が 
発生 し た 場合 に は 、 NULL を 返し ます 。 


・int remove(const char far * flename): 
ファ イル を 削除 し ます 。 エラ ー が 発生 し た 場合 に は 、 0 以外 の 値 を 返し ます 。 
・ int rename(const char far * oldname, const char far *※ newname): 
ファ イル の 名 前 を 変更 し ます 。 現時 点 で は まだ 実装 され て いま せん 。 
A.1.3 変数 定数 
・FILE _iob 
プロ グラ ム が 利用 する FILE 構 造 体 の 配列 で す 。 ユー ザ プ ロ グラ ム で 定義 する こと で 、 最大 同 


時 オー プン 可能 な ファ イル 数 を 設定 で きま す 。 この 場合 に は 、 num_iob0 も 同時 に 定義 する 必要 
が あり まず 「 A.1.2 関数 プ マ クロ 」 の 項 num_iob0」 参照)。 


・char_printf_bufl 


printf0、 fprintf0 が 内 部 的 に 利用 する フォ ー マ ッ ト 文字 列 生成 用 の バッ ファ で す 。 標準 サイ ズ 
は 256 バ イト と な っ て いま す 。 これ より 長く な る 文字 列 を 生成 する 場合 に は 、 ユー ザ プ ロ グラ ム で 適 
切な サイ ズ の _printf_bufll を 定義 し ます 。 


A.1.4 型 

・ FILE 構 造 体 

ファ イル 操作 全般 に 利用 され る 構造 体 で が 「 A.1.3 変数 / 定 数 」 の 項 _iob」 参 照 )。 
A.1.5 printf の 書式 


WonderWitch 用 標準 ライ ブラ リ に 含ま れる printf 系 の 関数 で は 、 以下 の 形式 で 書式 を 指定 
し ます 。 


%[-] [0] [na] [,] [11 tdlulxlcls) 


各 書 式 制御 文字 の 意味 は 次 の 通り で す 。 
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string 


制御 文字 表示 内 容 


d 10 進 符号 付き 整数 を 表示 し ます 

Uu 10 進 符号 な し 整数 を 表示 し ます 

X 16 進 数 を 表示 し ます 

C 1 文字 出力 し ます 。 文字 コー ド を char で 与え ます 
s 文字 列 を 表示 し ます 

- 出力 を 左 詰め し ます 

0 余っ た 桁 を '0 で 埋め ます 

n 出力 桁 数 を 10 進 数 で 指定 し ます 


10 進 数 を 出力 する 際 、 3 桁 ご と に ',' で 区 切り ます 
| d、u、x と 組み 合わ せ た 場 合 、 数 値 が long で ある こと を 表し ます 
s と 組み 合わ せ た 場 合 、 文 字 列 を far ポ イン タ で 渡す こと を 表し ます 
注意 " %" 自体 を 出力 する た め に は 、 %%" と 記述 し ます 。 
注意 浮動 小数 の 出力 に は 対応 し て いま せん 。 


A.2 string 
A.2.1 概要 
文字 列 操 作 を 行う た め の 関 数 群 で す 。 
項目 内 容 
ヘッ ダー ファ イル string.h 
多重 include 回 避 用 マク ロ _STRING_H_ 
ライ ブラ リフ ァイル libww.lib 


A.2.2 関数 プ マ クロ 
・int strlen(const char far * str): 
文字 列 の 長 さ を 得 ます 。 
・char far * strcpy(char far * dest const char far * src): 
文字 列 を コピ ー し ます 。 src か ら 始ま り 、\O で 終端 する 文字 列 を 、 dest に コピ ー し ます 。 
・char far * strncpy(char far *※ dest const char far * src, int len): 


部 分 文字 列 を コピ ー し ます 。 src か ら 始ま り 、 ハ 0 で 終端 する 文字 列 を 、 最大 len バ イト 、 dest に 
ヨ ピ ー し ます 。 


・char far * strcat(char far *※ dest const char far * src): 


文字 列 を 連結 し ます 。src か ら 始ま り 、 い 0 で 終端 する 文字 列 を 、 dest か ら 始ま る 文字 列 の 後 
ろ に 連結 し ます 。 
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・int strcmp(const char far * left const char far *※right: 


文字 列 を 比較 し ます 。 left か ら 始ま り 、\O で 終端 する 文字 列 と 、 right か ら 始ま る 文字 列 を 、 各 
バイ ト ご と に 辞書 順 で 比較 し ます 。 完全 に 一 致し て いる 場合 に は 0 を 、 right の ほう が 若い 場合 に 
は 負 の 値 を 、 そ う で な けれ ば 正 の 値 を 返し ます 。 


・int strncmp(const char far * left const char far *※ right int len): 
部 分 文字 列 を 比較 し ます 。 先頭 の len 文 字 の み を 比較 する こと を 除い て 、 strcmp( と 同様 で す 。 


・char far * strchr(char far * str, char ch): 
char far * strrchr(char far * str, char ch): 


文字 列 中 で 特定 文字 が 現れ る 位置 を 調べ ます 。 文字 列 str の 中 の 文字 c を 、 strchr( は 先頭 か 
ら 、 strrchr0 は 未 尾 か ら 探し ます 。 見 つか っ た 場合 に は その 位置 を 指す far ポ イン タ を 、 見 つか ら 
な い 場合 に は NULL を 返し ます 。 


A.3 fcntl 
A.3.1 概要 
ファ イル ハン ドル を 使っ て 、 ファ イル 操作 を 行う 低 レ ベル ライ ブラ リ で す 。 
項目 内 容 
ヘッ ダー ファ イル fcntl.h 
多重 include 回 避 用 マク ロ _FCNTL_H_ 
ライ ブラ リフ ァイル libww.lib 


A.3.2 関数 プ マ クロ 
・FsIL far*※fs_getll(FS fs): 
指定 し た FS を ハン ドリ ング する FsIL へ の far ポ イン タ を 取得 し ます 。 
・FS fs_getfs(int fd): 
ファ イル ディ スク リプ タ か ら 、 オー プン 中 の ファ イル を 格納 し て いる FS を 得 ます 。 
・void fs_touch(const fent_tfar * fentp, tme_t datetime): 
ファ イル の 最終 更新 時 刻 を 設定 し ます 。 


・charfar※fsS_dup_fname(const char far *※ fname): 


ファ イル 名 を オペ レー ティ ング シス テム 内 部 の ワー クエ リア に コピ ー し ます 。 シス テム が 利用 する 機 
能 の た め 、 ユー ザ プ ロ グラ ム で 呼び 出し て は いけ ませ ん 。 
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・fent_tfar※fS_do_find(FS fs, const char far *※ fn, int len): 


指定 し た FS の 、 fn か ら 始ま り len バ イト で 表わさ れる 名 前 の ファ イル エン トリ を 得 ま す 。 見 つか ら 
な い 場合 に は 、 NULL を 返し ます 。 


・fent_tfar*※fS_find(FS fs, const char far * fname): 


指定 し た FS の 、 fname で 表わさ れる 名 前 の ファ イル エン トリ を 得 ま す 。 見 つか ら な い 場合 に は 、 
NULL を 返し ます 。 


・intfs_to_filepath(const char far * path, filepath_tfar *※ fpath): 

与え られ て パス 名 path を 、 デイ レク トリ 名 と ファ イル 名 に 分 解 し 、 filepath_t 構 造 体 fpath に 格納 
し ます 。 指定 され た パス 名 を 含む ダレ クト リ が 存在 し な い 場 合 に は 、E_FS_FILE_NOT_FOUND 
を 返し ます 。 


・void fs_to_absolute(const char far * path, char far * buffer): 


与え られ た パス を カレ ント ワー キン グイ レク トリ の 情報 を 用 いて 絶対 パス に 変換 し ます 。 既に 絶 
対 パス の 場合 に は 、 path の 内 容 を その まま buffer に コピ ー し ます 。 


・void fs_setinfo(const char far *※ fname, const char far * info): 
ファ イル 情報 を 設定 し ます 。 


・int nument(const char far * dirname): 


昌 定 し た ディ レク トリ の ファ イル エン トリ 数 を 返し ます 。 デイ レク トリ が 見 つか ら な い 場合 に は 、 
E_FS_FILE_NOT_FOUND を 返し ます 。 この 関数 が 返す 値 は 、 デ ィ レ クト リ に 格納 し 得る ファ イ 
ル の 数 と 同じ で 、 現在 レク トリ に 格納 され て いる ファ イル 数 で は あり ませ ん 。 現在 格納 され て い 
る ファ イル 数 を 得る に は 、 getent0 で 各 エ ント リ を 取得 し 、 使用 中 の エン トリ 数 を 数 える 必要 が あ 
り ま す 。 


・int getent(const char far *※ dirname, int index, struct stat far * statbuf): 


指定 し た デイ レク トリ の index 番 目 の フ ァイル エン トリ の 情報 を statbuf に 得 ます 。 正常 に 取得 で 
きた 場合 に は 、E_FS_SUCCESS を 返し ます 。 ディ レク トリ が 見 つか ら な い 場合 に は 、 
E_FS_ FILE_NOT_FOUND を 返し ます 。 範囲 外 の index を 指定 し た 場合 に は 、 
E_FS OUT_OF_BOUNDS を 返し ます 。 


・int stat(const char far * path, struct stat far * statbuf): 


指定 し た パス の ファ イル エン トリ の 情報 を statbuf に 得 ま す 。 正 常に 取得 で きた 場合 に は 、 
E_FS_SUCCESS を 返し ます 。 指定 し た パス が 見 つか ら な い 場合 に は 、E_FS_FILE_NOT_ 
FOUND を 返し ます 。 
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・int open(const char far *※ path, int flags, int perms): 


指定 し た パス の ファ イル を オー プン し ます 。 flags に は 、 ファ イル を オー プン する モー ド を 、 
O_RDONLY、 O_WRONLY、O_RDWR の いずれ か で 与え ます 。 正常 に オー プン され た 場合 、 
ファ イル ディ スク リプ タ を 返し ます 。 ファ イル が 見 つか ら な い 場合 、E_FS_FILE_NOT_FOUND を 
返し ます 。 指定 し た オー プン モー ド が 許可 され て いな い 場合 、E_FS_PERMISSION_DENIED 
を 返し ます 。 


・int close(int fd): 

ファ イル ディ スク リプ タ fd で 表わさ れる オー プン 中 の ファ イル を クロ ー ズ し ます 。 正常 に クロ ー ズ 
し た 場合 に は 、E_FS_SUCCESS を 返し ます 。 ファ イル が オー プン され て いな い 場合 に は 、E_FS_ 
FILE_NOT_OPEN を 返し ます 。 


・int read(int fd, char far *※ buf int n): 


ファ イル スク リプ タ fd で 表わさ れる オー プン 中 の ファ イル か ら 、 buf に 最大 n バ イト 読み 込み ま 
す 。 実際 に 読み こん だ バイ ト 数 を 返し ます 。 エラ ー が 発生 し た 場合 に は 、 負 の 値 を 返し ます 。 


・int write(int fd, char far *※ buf int n): 


ファ イル ディ スク リプ タ fd で 表わさ れる オー プン 中 の ファ イル に 、 buf か ら 最大 n バ イト 書き 込み ま 
す 。 実際 に 書き 込ん だ バイト 数 を 返し ます 。 エラ ー が 発生 し た 場合 に は 、 負 の 値 を 返し ます 。 


・void far ※ mmap(const char far * path): 


指定 され た ファ イル を メモ リ 空間 に マッ プ し 、 アド レス を far ポ イン タ で 得 ます 。/rom0 に 存在 す 
る ファ イル の み 、 mmap( ) す る こと が で きま す 。 失敗 し た 場合 に は 、 NULL を 返し ます 。 


・int creat(const char far * path, int perms, int count): 


モー ド perms、 ブロ ッ ク 数 count の ファ イル を 、 パス path に 作成 し ます 。 正常 に 作成 し た 場合 に 


は 、E_FS_SUCCES を 返し ます 。 書き 込み で き な い デイ レク トリ が 指定 され た 場合 に は 、E_FS_ 


PERMISSION_DENIED を 返し ます 。 
・int unlink(const char far * path): 


パス path で あら わ さ れ る ファ イル を 削除 し ます 。 正常 に 削除 し た 場合 に は 、E_FS_SUCCES を 
返し ます 。 ファ イル が 見 つか ら な い 場 合 に は 、E_FS_FILE_NOT_FOUND を 返し ます 。 


・Ilong lseek(int fd, long offset int origin): 


ファ イル ディ スク リプ タ fd で あら わ さ れ る オー プン 中 の ファ イル の ファ イル ポイ ンタ 位置 を 移動 し ま 
す 。origin に は 移動 の 起点 と な る 場所 を 、 0 ファ イル 先頭 か ら )、 て 現在 位置 か ら )、? ファ イル 未 
尾 か ら ) で 指定 し ます 。 範囲 外 と な る 値 を 指定 し た 場合 に は 、E_FS_OUT_OF_BOUND を 返し 
ます 。 ファ イル が オー プン され て いな い 場合 に は 、E_FS_FILE_NOT_OPEN を 返し ます 。 
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・long tell(int fd): 


ファ イル ディ スク リプ タ fd で 表わさ れる オー プン 中 の ファ イル の ファ イル ポイ ンタ 位置 を 得 ます 。 フ 
ァイル が オー プン され て いな い 場合 に は 、E_FS_FILE_NOT_OPEN を 返し ます 。 


・int chmod(const char far * path, int mode): 


指定 し た ファ イル の モー ド を 変更 し ます 。 正常 に 変更 し た 場合 に は 、E_FS_SUCCESS を 返し 
ます 。 ファ イル が 見 つか ら な い 場合 に は 、E_FS_FILE_NOT_FOUND を 返し ます 。 


・int chdir(const char far *※ dirname): 


カレ ント ワー キン グイ レク トリ を 指定 し た デイ レク トリ に 移動 し ます 。 正常 に 移動 し た 場合 に は 、 
E_FS_SUCCES を 返し ます 。 デイ レク トリ が 見 つか ら な い 場合 、E_FS FILE_NOT_FOUND を 返 
し ます 。 


・char far * getcwd(char far * buffer, int size): 

カレ ント ワー キン グレ クト リ を 得 ま す 。 最大 size バ イト の buffer を 得 ます 。 
A.3.3 変数 定数 

・E_FS_SUCCESS 

正常 終了 を 表す コー ド で す 。 

・E_FS_FILE_NOT_FOUND 

指定 し た パス が 見 つか ら な いこ と を 表わす コー ド で す 。 

・E_FS_PERMISSION_DENIED 

指定 し た 処理 が 許可 され て いな いこ と を 表わす コー ド で す 。 

・E_FS_OUT_OF_BOUND 


指定 し た 値 が 範囲 外 で ある こと を 表わす コー ド で す 。 


・E_FS_NO_SPACE_LEFT 
容量 や エン トリ に 空き が な いこ と を 表わす コー ド で す 。 
・E_FS_FILE_NOT_OPEN 


ファ イル が オー プン され て いな いこ と を 表わす コー ド で す 。 


89 


付録 人 FreyaOS 標準 ライ ブラ リ 仕様 


A.3.4 型 
・filepath_t 構 造 体 


パス 名 を FS と ファ イル 名 に 分 解す る た め に 利用 され る 構造 体 で が 「 A.32 関数 プ マ クロ 」 の 
「 fs to filepath」 の 項 参 照 )。 


A.4 stdIib 


A.4.1 概要 
標準 的 に 利用 され る 関数 、 お よび マク ロ で す 。 OS の バー ジョ ン を 取得 する 関数 も ここ に 含ま れ 
ます 。 


項目 内 容 

ヘッ ダー ファ イル stdlib.h 

多重 include 回 避 用 マク ロ _STDLIB_H_ 
ライ ブラ リフ ァイル libww.lib 


A.4.2 関数 プ マ クロ 
・int rand(void): 
乱数 を 生成 し ます 。 あら かじ め srand0 を 呼び 出し て 、 種 を 設定 し て お きま す 。 
・void srand(unsined seed): 


乱数 の 種 を 設定 し ます 。 rand0 を 呼び 出す 前 に 実行 し ます 。 引数 の seed に 与え る 数 に よっ て 、 
rand(0 で 生成 され る 乱数 の 系 列 が 変化 し ます 。 


・void memcpy(void far *※ dest void far *※ src, size_t Count): 


メモ リブ ロッ ク を コピ ー し ます 。 src か ら dest に count バイ ト の デー タ を コピ ー レ し ます 。 転送 元 と 転 
送 先 の 領域 は 重なっ て いて も 構い ませ ん 。 


・void memset(void far *※ dest int c, size_t count): 


メモ リブ ロッ ク に 同一 デー タ を セッ ト し ます 。 dest か ら 始ま る count バ イト の 領域 に 、c を 設定 し 
ます 。 c の 値 は 、 下位 8 ビッ ト の み が 有 効 で す 。 


・unsigned os_get_version(): 
FreyaOS の バー ジョ ン を 得 ま す 。 上 位 か ら メ ジャ ー バ パー ジョン 、 マイ ナー バー ジョ ン 、 サブ マイナ 


ー バ ー ジ ョ ン の 順に 、 そ れ ぞ れ 、 4 ピッ ト 、 4 ビッ ト 、 8 ビッ ト ずつ の 値 を 16 ビッ ト の 符合 な し 整数 と し 
て 返し ます 。 
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イジ ダ イレ クト ライ ララ 


・min(a, b) マ クロ 


2 つの 値 8、b を 比較 し て 小さ い ほう を 得 ます 。 得 られ る 値 の 式 は 2 度 評価 され る の で 、 注意 が 
必要 で す 。 


・max(a, b) マ クロ 


2 つの 値 8、b を 比較 し て 大 きい ほう を 得 ます 。 得 られ る 値 の 式 は 2 度 評価 され る の で 、 注意 が 
必要 で す 。 


A.4.3 変数 / 定 数 
・RAND_MAX 


rand0 で 得 ら れる 乱数 の 最大 値 で す 。 


5 内 Si 
A.5 標準 イン ダイ レク ト ライ ブラ リ 
標準 イン ダイ レク トラ イブ ラリ は 、 Frey aOS で 標準 的 に イン ター フェ イス が 定め られ て いる イン ダイ 
レク トラ イブ ラリ 群 で す 。 
バー ジョ ン 1.0 で は 、 以下 の も の が \WWitch\sys\indirecth に 定義 され て いま す 。 


・ lbIL 

・ ProclL 

・ RunnablelL 
・FslL 
・StreamlL 


A.5.1 IlibIL 
llibIL は 、 指定 し た ファ イル 名 の イン ダイ レク トラ イブ ラリ を 探し 、 ア ドレ ス 解 決 を 行い ます 。 シス テ 
ム 標 準 の llibIL は /kern/@ilib に 配置 され て いま す 。 


typedefF s ヒ と uc 七 { 

エエ SuDG エ : 

ュ n モ (Far ※_open) (char Ear 玉 ュ 1name, TIL, Far ポ ェ 1buf) : 

ュ n モ E (Far ※ ポ _open_sys も em) (Char Far ポ ュ 1name, TL Far 玉 ュ 1buE) : 
) エ 1ibTL : 


・_oOpen 


/rom0、 /kern の 順に 走査 し ます 。 


・_open_system 


/kern の み を 走査 し ます 。 


A.5.2 ProclL 
ProclL は プロ セス 制御 を 行い ます 。 シス テム 標準 の ProclL は /kern/@proc に 配置 され て いま す 。 
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typedefF s ヒ と エ uc 七 { 
エエ SuD@ と : 
Yod far 水 (Far 素 1oad) (char Far *※ command) : 
ュ n 上 (Fa エ run) (od Fa 玉 en モエ ッ , 1n argo, Char far * ar 
玉 argVY) : 
in 上 (Far 玉 _exxec) (char Far oommand, in arqgo, Char Ear 
Ear 素 arqdV) : 
Yo1d (Far ※ exi モ ) (nt ex1tcode) : 
Yo1d (far ポ yie1d) () : 
nt (Far 玉 _suspend) (in pobid) : 
Yo1d (Ear ポ _ resume) (in モ pob19) : 
ュ n 上 (Far 玉 _ swap) (in pcbd) : 
} ProoT エ : 


・ _load 


子 プ ロ セ ス を ロー ド し ます 。 初期 化 済み デー タ が 転送 され ます 。 


・ _run 


子 プ ロ セ ス を 実行 し ます 。 _load の 戻り 値 を entry 引 数 に 取り ます 。 


・ _exX@eC 


子 プ ロ セ ス を ロー ド し 、 実行 し ます 。 


・ _exit 
プロ セス を 終了 し ます 。 明示 的 に 呼ば な く て も 、 exit( 関 数 や main0 か ら の 復帰 に よっ て 暗黙 
の うち に 呼ば れ ま す 。 


・_yield 
待機 中 の 他 の プロ セス に 実行 権 を 委譲 し ます 。 


・ _SusSDend 
プロ セス を サス ペン ド し ます 。 


・ _resume 


指定 し た プロ セス を リ ジ ュ ー ム し ます 。 


・ _SWaD 


自分 自身 を サス ペン ド する と 同時 に 、 指定 し た プロ セス を リ ジ ュ ー ム し ます 。 


A.5.3 RunnablelL 
RunnablelL は 、 通常 の プロ グラ ム と 同様 の イン ター フェ イス を イン ダイ レク トラ イブ ラリ と し て 提供 
し ます 。 ユー ザ シ ェ ル は RunnablelL と し て 提供 し ます 。 


typedefF s ヒ と uo { 


エエ SuDG エ : 
ュ n 上 (Far ポ exxeo) (in 七 argo, Char Ear * ポ arqgv[] ) : 
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} Runnab1eTT : 


A.5.4 FsIL 
FsIL は 、 フ ァイル シス テム の 機能 を 提供 し ます 。 FsIL の メソ ッ ド 群 は 、 ほぼ 低 レ ベル |/C 関 数 群 
に 対応 し 、 低 レ ベル |/O 関 数 群 か ら 呼び 出さ れ ま す 。 


typedef sruo 七 _FsTT, { 
エエ SuD@e エ : 
Fent t Far (Far 水 entries) (FS Fs): 
in (Far 玉 _n entries) (FES Es) 
ェ int (Far 素 _qetent) (FS Es, nt n, fen 上 七 Far 六 Fep) : 
ェ int (Far 素 Findent) (FS Fs, ohar Far 六 fname, fen 上 上 far * Fep) : 
Yo1d far 玉 (Far 北 _mmap) (FS fs, char far Fname) : 
ェ int (Far 玉 _ open) (FS Fs, ohar Far 水 Fname, nt mode, nt perms) : 
in (Far *※ oc1ose) (in fd) : 
in (Far 素 _ read) (in 上 FEd, char far 水 bufE, in 1en) : 
in (Far 六 _ write) (in fd, ohar far 水 buE, in 1en): 
1ong (far 玉 1seek) (in も fd, 1ong oEfFse, in origin) : 
in (Far _chmod) (FES Fs, ohar far 玉 fFname, in mode) : 
in (Far ネ freeze) (FS fs, ohar far * fname) : 
in (far *_me1t) (FS fs, ohar far * fname) : 
in (Far *_orea も ) (FS Fs, Fen ヒ 上 Far 六 Fep) : 
in (far un1ink) (FS Fs, ohar Far fname) : 
in (Far newfs) (FS Fs) : 
nt (Far 氷 _ defFrag) (FS Es) : 
unsigned 1ong (Far ※ _spaoe) (FS Fs) : 

] FsTL: 


以下 の 4 つの メソ ッ ド は 、 対応 する 低 レ ベル |/0 関 数 が あり ませ ん 。 


・ _freeze 


現在 使わ れ て いま せん 。 


melt 


現在 使わ れ て いま せん 。 


newfs 


ファ イル シス テム 全体 を クリ ア し ます 。 


_defrag 
ファ イル シス テム に 残っ て いる ゴミ ファ イル を 回 収 し 、 可能 な 限り 空き 領域 を 増やし ます 。 


A.5.5 StreamlL 
StreamlL は 、 スト リー ム 入 出力 を 行う イン ダイ レク トラ イブ ラリ で す 。/kern/@aux な どの 実体 で 、 
FsIL 内 部 か ら 利用 され ます 。 
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モ typedeF ss モエ uo _Fhand1e 上 Far *Fhand1e p: 
も typedeE Ss ヒエ uo 上 _S モ reamTT { 
エエ SuDG エ : 
ュ n モ E (Far ※_open) (Ehand1e_p E): 
nt (Far ※ co1ose) (Ehand1e_p E): 
nt (Far ポ _ read) (FEhand1le_ p FE, ohar far 玉 buE, in 1en): 
n 上 (Far 玉 _wri モ e) (Ehand1e_p FE, ohar far 玉 buE, in 1en) : 
} StreamTT: 


・ _oOpen 


スト リー ム を オー プン し ます 。 


_close 
スト リー ム を クロ ー ズ し ます 。 


_read 
スト リー ム か ら 指定 バイ ト 読み 込み ます 。 


_wWrite 
スト リー ム に 指定 バイ ト 書き 込み ます 。 


I 


A.6 SoundIL 


A.6.1 概要 
SoundIL は HBLA NK 割 り 込み を 利用 し て 、 演奏 デー タ に 基づい た 音楽 演奏 を 行う ドラ イ バ で す 。 


A.6.2 機能 
SoundIL は 以下 の 機能 を 提供 し ます 。 


・BGM 人 本 ラッ ク )、 効果 次 相 ラッ ク )、 PCM ボ イス の 同時 演奏 

・MMIC Music Macro Language) で 記述 し た シー ケン ス デ ー タ を あら か じ め コ ン バー タ で バ 
イナ リ デ ー タ に 変換 、 また は ド ライ バ で 朋 次 変換 し て 演奏 

・ 音 源 デ ー タ に は 、 波形 、 エン ベロ ー プ 、 ビ ブラ ー- ト を 設定 可能 

・ チ ャ ン ネ ル 3 の ノイ ズ モ ー ド で ドラ ム パ - 下 を 演奏 可能 


A.6.3 デー タ の 種類 
SoundIL は 音楽 演奏 の た め に 以下 の デー タ を 使用 し ます 。 


・BGM シ ー ケ ンス デー タダ テキ スト ( .mml)、 リ ソー ズ .f) ) 
・ 効果 音 シ ー ケ ンス デー タダ テキ スト ( .mml)、 リ ソー ズ .f) ) 
・ 音源 デー タダ テキ スト ( .prg)、 リ ソー ズ .fr) ) 
・PCM ボ イス デー タダ リソー ズ .f) ) 


これ ら の デー タ を まとめ で 「 演奏 デー タ 」 と 呼び ます 。BGM や 効果 音 の シー ケン ス デ ー タ を 演奏 


する に は 、 音源 デー タ が 必要 で す 。 た だ し 、 サウ ンド ドラ イ バ に は 、 デフ ォ ル ト の 音源 デー タ が 格納 
され て いる の で 、 通常 は 音源 デー タ を 読み 込む 必要 は あり ませ ん 。 
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A.6.4 ファ イル の 説明 
SoundIL を 使用 する た め に 必要 と な る ファ イル 群 は 以下 の 通り で す 。 


ファ イル 名 内 容 

soundiil サウ ンド ドラ イ バ 本 依 SoundIL) 
player.fx 演奏 用 ツー ル 

sndcnv.exe 各種 サウ ンド デー タ の コン バー タ 
sample.mml BGM サ ンプ ル MML テ キス ト ) 
sample.fr BGM サ ンプ ル リソー ス ) 
se.mml 効果 音 サ ンプ ル MML テ キス ト ) 
se.fr 効果 音 サ ンプ ル リソー ス ) 

inst prg 音源 デー 人 テキ スト ) 

instfr 音源 デー 人 リソー ス ) 

voice.fr PCM ボ イス デー 人 リソー ス ) 

il sound.h サウ ンド ド ライ バ ヘ ッ ダ ファ イル 
resource.h リソー ス 定義 用 ヘッ ダフ ァイル 


A.6.5 テス ト 演奏 の 手順 


1. sound.il、player.fk を WonderWitch 専 用 カー トリ ッ ジ に 転送 

2. sample.* 、se.*※、voice.fr 等 の 演奏 デー タ を 転送 演奏 デー タ は 、/rom0、/fam0 の どちら 
へ 格納 し て も よい )。 また 、 MML テ キス ト 、 リ ソー ス ど ちら の ファ イル も 演奏 可能 

3. player.fK プレ イヤ ー) を 起動 

4. 演奏 し た い フ ァイル を 選択 。 あと は 、 画面 の 指示 に し た が う 

5. ファ イル の 選択 を B ボ タン で キャ ン セ ル す る と 、 シ リア ル 通 信 回 線 か ら MML テ キス ト を 受け 
取っ て 演奏 する モー ド に な る 。 TeraTerm 等 を 起動 し て 、 MML テ キス ト を 送信 し て みる 。MML 
の 終端 文字 / パ スラ ッシュ ) を 送信 し た 時 点 で 演奏 開始 


A.6.6 サウ ンド ドラ イ バ の 使い 方 
ユー ザ ア プ リケーション が サウ ンド ドラ イ バ の 機能 を 使う に は 、 あ ら か じ め soundil を 転送 し て お 
か な けれ ば な り ま せん 。 サウ ンド ドラ イ バ を 使う プロ グラ ム は 、 il_sound.h を イン クル ー ド し ます 。 


#inC1ude < ュ 1 sound.h> 


また 、 演奏 デー タ を プロ グラ ム に リソー ス と し て 組み 込む 場合 に は 、 resource.h も イン クル ー ド し 
ます 。 


# エ nmC1udeG こと GSOu エ ご @ .h> 

次 に 、 SoundIL の 関数 テー ブル と な る グロ ー バ ル 変 数 を 定義 し ます 。 

SoundTT, soundTL: 

サウ ンド ドラ イ バ の 関数 は 、 il_soundh で マク ロ 定義 さ れ て お り 、 実際 に は soundIL の 関数 テー 


ブル を 介し て 呼び 出さ れ ま す 。 


95 


付録 人 FreyaOS 標準 ライ ブラ リ 仕様 


以下 に 、 サウ ンド ドラ イ バ を 使う プロ グラ ム の 例 を 示し ます 。 
extern BYTE 斑 heap: 


ゞ od main () 


{ 


3E(open_sound_ ュ 1 (gsoundT エ TL) != EEFS_SUCCESS) { 
/ * ド ライ バ が 存在 し な い / 
エ てら G 七 un / 
} 
sounddr マ 。 ュ 1n ュ モ () : /* ドラ イ バ 用 ワー ク の 確保 */ 
sound_open ( ) : / 斑 HBLANK 守 りり 込み を 開始 */ 


Parse_mm1 (_heap, "CDEFG", 0): /※ ヒ ー プ 領域 へ 演奏 デー タ を 格納 */ 
bgm_p1ay(_heap, PLAY_LOOP) : / * 演奏 開始 */ 
key_wai () : 


sound_c1ose () : /* HBrANK 割 り 込み 停止 */ 
sounddry_re1ease () : / 了 * ド ライ バ 用 ワー ク の 開放 */ 
} 


A.6.7 演奏 デー タ 
還 MML テ キス ト の 変換 


bgm_play(0、 se_play (が 受け 取る シー ケン ス デ ー タ は 、 リ ソー ズ バイ ナリ ) 形式 で す 。 し た が 
っ て 、 MML で 記述 し た テキ スト デー タ は 、 あら か じ め リ ソー ス に 変換 し な く て は な り ま せん 。 これ 


に は 、 4 通り の 方 法 が あり ます 。 


1. プロ グラ ム 中 に MML テ キス ト を 文字 列 と し て 持ち 、 parse_mml() で 逐次 変換 し て 演奏 する 


長所 リソー ス 用 パッ ファ は 、 最も 大 きい ] 曲 分 だ け 確 保 す れ ば よい 


短所 parse_mml0 は 処理 時 間 を 食う た め 、 長い 曲 の 場合 演奏 が 1 テン ポ 遅 れる 可能 性 が ある 


2. プロ グラ ム 中 に MML テ キス ト を 文字 列 と し て 持ち 、 初期 化 時 に 一 括 し て 変換 し て し まう 
長所 : 演奏 時 の タイ ムラ グ は な い 
短所 : 全て の リソー ス を 格納 する パッ ファ が 必要 と な る 


3. MML テ キス ト を sndcnv で リソー ス フ ァ イル .fr) に 変換 し 、 mkfent で プロ グラ バ .bin) に 付加 


長所 リソー ス 用 パッ ファ を 必要 と し な い 
g 所 : リソー ス を アク セス する た め の コ ー ド が 必要 


4. MML テ キス ト を sndcnv で アセ ン ブ ラ の ソー ス フ ァ イル に 変換 し 、 プロ グラ ム に リン ク し て 使 ) 
長所 : 特に な し 
短所 アセ ン ブ ラ が 必要 


固 BGM と 効果 音 


サウ ンド ドラ イ バ で は 、BGM を 演奏 し ながら 、 一 時 的 に 効果 将 Sound Effect) を 鳴ら すこ と 
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が で きま す 。 WonderSwan の 音源 は 4 チャ ン ネ ル で す の で 、 効果 音 が 鳴っ て いる 間 は 、 効果 音 が 
使う チャ ン ネ ル 最大 2) が 、BGM と 置き 換わる こと に な り ま す 。 

BGM も 効果 音 も MML で 記述 し ます が 、 リ ソー ス 形 式 は 異な っ て いま す 。 BGM は 、 1 つの リ ソ 
ー ス に 1 つの 曲 シー ケン ス ) し か 格納 で きま せん が 、 効果 音 は 、 1 つの リソー ス に 複数 の シー ケン 
ス を 格納 で きま す 。 


還 ド ライ バ に つい て 
サウ ンド ドラ イ バ の 本 体 (演奏 部 分 ) の 作者 は 、 小宮 山 郁 夫 氏 で す 。 


Original SoundDriver for WonderSwan Version 1.0 Copyright(C) Ikuo Komiyama 


・sound_open() を 呼び 出す と 、 演奏 し て いる か どう か に か か わら ず 、 常に HBLANK タ イマ ー 割 
り 込 み が か か り ま す 。 HBLANK 割 り 込 み の オ ー バ ー ヘ ッ ド を 減ら す た め に 、 通常 の 音楽 演奏 
時 は 、 HBLANK を 1/16 に 間 引 い て 使用 し ます 。 PCM ボ イス 再生 中 の み 、 HBLANK を 1/1 に 
再 設定 し ます 。 

・ エ ン ベロ ー プ や ビブ ラー ト の 周期 は 、 曲 の テン ポ に 連動 し て 変化 し て し まい ます 。 

・ ポ ル タ メ ント ( 音階 の 連続 変化 CD 上 ) で は 、 短い ステ ッ プ で 大 き な 音 程 差 を 指定 する と 、 ゼ 
除算 が 起き る 可能 性 が あり ます 。 

・set instrument() で 指定 する 音源 デー タ は 、 パラ グラ ズ 16 バ バト ) 境界 に 位置 し て いる 必 
要 が あり ます 。 これ は 、 ド ライ バ が 音源 デー タ の 位置 を 、 far ポ イン タ で は な く 、 セグ メン ト 値 
で 管理 し て いる た めで す 。 音源 リソー ス を 参照 する 場合 は 、 個々 の リソー ス は 、 mkfent で ア 
ペン ド する 際 に パラ グラ フ 境界 に 先頭 が 位置 する よう パ デ ィ ン グ され ます の で 、 こ の 制限 を 
意識 する 必要 は あり ませ ん 。parse_inst() で 音源 リソー ス を バッ ファ へ 格納 する 際 は 、 バ ッ 
ファ の 先頭 が パラ グラ フ 境界 に 位置 し て いる 必要 が あり ます 。 


A.7 MML 文 法 


A.7.1 概要 
SoundIL が 解釈 する MML の 文法 で す 。 


言語 の 中 で 文字 列 と し て 記述 する か 、 テキ スト ファ イル に 記述 。 
・Ox01 て Ox20、 Ox80 て 0xFF の コー ド は 無視 する 。 
・ 英 大 小文字 は 識別 し な い 。 
・「 S$ 英 字 」 は 、 将来 的 に は マク ロ に 使用 する 予定 。 
・ チ ャ ン ネ ル 指 定 は 、 BGM で は 4 つ 、 SE で は 2 つま で 。1 つ の MM 文字 列 中 に 何 度 現れ て も 
よい 。 


A.7.2 文法 
書式 内 容 
#O 一 お 8 チャ ン ネ ル 指 定 。 デ フォ ルト は BGM:0、 SE:3 
井 現在 の ト ラック を ミュ - 下 (トグル) 
# 現在 の ト ラッ ク 以外 を ミュ ー ト (トグル ) 
A~GEHInl ノ 
Ri 価 符 
Ln  n=1 一 64(④ ノ - 二 で 音 長 を 指定 し な い 場 合 の 音 長 
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On  n=0 て 11 (④ オク ター ブ 。10 以 上 は ドラ ム 用 

Qn  n=]1-8(7 ゲ - 下 タイ ム 

VHi-In n=0 て 15 (15) ボリ ュー ム 。 +/ を 付け る と 現在 値 に 加算 減算 
PHI-]n n=-15 て 15 (0) パン ポッ ト 。 n=-15 左 )ー《 中 央 ) て +15 右 ) 


TH!-]n n=1 て 255 テン ポ 。 +/ を 付け る と 現在 値 に 加算 / 大 算 

< 1 オク ター ブ 下げ る 

> 1 オク ター ブ 上 げ る 

_n トラ ンス ポー ズ 。 -12:1 オク ター ブ 下 。 +121 オク ター ブ 上 
^n(^n) 音 長 の 加算 

(nLml) ステ ッ プ & ゲー ト 直接 指定 

& タイ 。 直 前 の ノー ト で step=gate と する 

ポル タメ ント 。 前 の ノー ト か ら 次 の ノー ト へ 連続 的 に 音程 を 変化 
@n 音色 番号 

@En エン ベロ ー プ 番号 。 0 エン ベロ ー プ 無し 

@ Bn ビブ ラー ト 番号 。 0 ビブ ラー ト 無し 

@Sn n=-128-- 127。 スイ ー プ 値 。 0 スイ ー プ 無し 

@Nn n=0 て 7。 ノイ ズ CH3 の み ) 

[n n=1-。 ル ー プ 開始 。 n は 繰り 返し 回 数 。 省略 する と 2 回 


] ルー プ 終 了 。 ネス ト は 3 段階 まで 
最後 の 繰り 返し で その 階層 の ルー プ を 抜け る 


! 以降 の 演奏 を 停止 
5 行末 まで の 文字 列 を コメ ント と みな す 


( 参考 ) 

mml2asm.txt by Charley 
mml2mid.txt http://www.platz.orjp/ mml2mid/ 
N88BA SIC MML( スピ ー ク ボー ド 取 説 ) 


A.8 音源 デー タ 書式 
A.8.1 概要 
SoundIL を 利用 し て 音楽 演奏 を 行う 際 に 用 いる 音源 デー タ を 定義 する 書式 で す 。 


@ENV SFF01 SEE01 SDD01 SCC01 SBB01 SAA01 S9901 S8801 
S7701 S6601 S5501 S4401 S3301 S2201 S1101 
[SOOFF] : ル ー プ 
: リ リー ス 
S1101 $S1101 S1101 S1101 S1101 S1101 


ENV が ファ イル 中 に 現れ た 順に 、 1 番 か ら 番 号 が 付き ます 。 0 番 は エン ベロ ー プ な し の 指定 に 
いら れ ま す 。 最大 64 個 まで 定義 で きま す 。 MML コ マン ド @E で 指定 する 数 値 は この 番号 で す 。 
各 数 値 は 、 以下 の 意味 に な り ま す 。 た だ し 、$ 0000 は 指定 で きま せん 。 
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SFF01 


性 、 継続 ステ ッ プ 数 (24 で 4 分 音符 
右 の ボリ ュー ム 較 
左 の ボリ ュー ム 暫 


発音 が 開始 され る と 同時 に エン ベロ ー プ が 順番 に 処理 され て いき 、 最終 的 .. ] で 囲ま れ 
た 範囲 を ルー プ し ます 。 この 例 で は 、 ルー プ に 入る と 音量 が O に な り ま す 。 ルー プ 部 分 は 必ず 指定 
し て 下さ い 。 

ルー プ 指定 の 次 に 、 リ リー ス の 指定 が あり ます 。 キー オフ され る と 、 現在 の エン ベロ ー プ 値 か ら 
リリ ー ス 値 を 減算 し て いき 、 左右 の エン ベロ ー プ が 共に 0 に な る と 発音 を 停止 し ます 。 リリ ー ス の 
指定 が な い 場 合 は 即座 に 発音 を 停止 し ます 。 


S1101 : リ リー ス 較 
ー 保持 ステ ッ プ 数 (24 で 4 分 音符 
右 ボ リュ ー ム の 減衰 量 図 


左 ボ リュ ー ム の 減衰 量 図 


数 値 が 大 きい ほど 速く 減衰 し ます 。 

例 )S2206: 左右 の ボリ ュー ム か ら 2 を 引い て 、6 ス テッ プ の 間 保 持 し ます 。 
A.8.2 ビブ ラー ト 設定 

@VIB 280[525.-21 : 1 

@VIB が ファ イル 中 に 現れ た 順に 、1 番 か ら 番号 が 付き ます 。0 番 は ビブ ラー ト な し の 指定 に 用 


いら れ ま す 。 最大 64 個 まで 定義 で きま す 。 MML コ マン ド @B で 指定 する 数 値 は この 番号 で す 。 
各 数 値 は 、 以下 の 意味 に な り ま す 。 た だ し 、 00 は 指定 で きま せん 。 


28,0 


継続 ステ ッ プ 数 (24 で 4 分 音符 ) 


元 の 音程 か ら の スイ ー プ 値 。 図 
ハー ドウ ェ ア の 周波 数 レジ スタ 
設定 する 値 に 足し 込む だ け な の 
音程 に よっ て 変化 の 幅 が 違い ま 
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発音 が 開始 され る と 同時 に ビブ ラー ト が 順番 に 処理 され て いき 、 最終 的 に [ .. ] で 囲ま れ た 範 
を ルー プ し ます 。 ルー プ は 必ず 指定 し て 下さ い 。 


| 


A.8.3 ドラ ム 音 の 設定 

MML で #3 を 指定 し た トラ ッ ズ CH3) で は 、 ノ イズ モー ド を 使っ て ドラ ム 音 を 発生 させ る こと が で 
きま す 。 ド ラム 音 は 、 @DRUM で 定義 し 、 通常 の ノー ト と 同じ よう に 音階 を 指定 し て 発音 し ます 。 
@DRUM は 最大 16 個 まで 定義 で きま す 。 各 定 義 に 対し 、 フ ァイル 中 に 現れ た 順に オク ター ブ 10 の 
C か ら 半音 ずつ オク ター ブ 11 の D+ ま で の 音階 が 割り 当て られ ます 。 

@DRUM の 定義 は 以下 の よう に 行い ます 。 


ノイ ズ の 種類 初期 分 周 比 加算 分 周 比 エン ベロ ー プ 番号 


@DRUM 3 999 -10 4 : #O BD(C) 
@DRUM 1 1400 -10 5 :#] SD(C サ 
・ ノ イズ の 種類 

0~7 な で 指定 で きま す 。 
・ 初 期 分 周 比 

0~-2047 ま で 指定 で きま す 。 数 値 が 高い ほど 高音 に な り ま す 。 
・ 加算 分 周 比 


1 ステ ッ プ ご と に 加算 する 数 値 で す 。 プラ ス な ら 発音 と 同時 に 音程 が 上 が っ て いき ます 。 マイ 
ナス な ら 発音 と 同時 に 音程 が 下がっ て いき ます 。 

・ エ ン ベロ ー プ 
@ENV で 指定 し た エン ベロ ー プ 番号 で す 。 0 を 指定 する と エン ベロ ー プ を 使用 し ませ ん 。 


A.8.4 波形 定義 


@WAVE SA8 SDC SEE SEF SDE SBC S9A S$89 S67 $56 $34 $12 S10 $11 S32 S75 : 抑 ) 


音色 の PCM 波 形 を 定義 し ます 。 ファ イル に 現れ た 順に 0 番 か ら 番号 が 付き ます 。 MML 中 で は 
直接 使用 せ ず 、 @PROG を 介し て 音色 を 指定 し ます 。 波形 は 、 4bitX 32 サ ンプ ル で 構成 され て お 
り 、 8 ピッ ト 数 値 で 16 個 指定 し ます 。 

波形 と デー タ の 関係 は | B.46 波形 設定 」 を 参照 し て くだ さい 。 


A.8.5 音色 定義 


波形 番号 エン ベロ ー プ 番号 ビブ ラー ト 番号 
@PROG 0 3 4 : お 


波形 、 エン ベロ ー プ 、 ビブ ラー ト を 1 つ に まとめ た も の を 音色 と し て 定義 し ます 。 ファ イル 中 に 現 
れ た 順に 0 番 か ら 番号 が 付き ます 。 MML 中 で @n と し て 参照 する の が この 番号 で す 。 
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付録 B 
FreyaBIOS 仕様 


B.1 画面 制御 BIOS 


画面 制御 BIOS は 、 キャ ラク タフ ォ ン ト デー タ の 設定 や スク リー ン の スク ロー ル な ど 、 画面 表示 に 
関す る 基本 的 な 機能 群 を 提供 し ます 。 


注意 : C 言 語 か ら の 呼び 出し 形式 に つい て は 、 \WWitch\include\sys\disph を 参照 し て くだ さい 。 


B.1.1 画面 表示 制御 設 冠 DISPLAY_CONTROL) 
画 引 数 


( な し ) 


画 機 能 詳細 
画面 の 表示 状態 を 設定 し ます 。 BX に 以下 の 情報 を ビッ トマ ッ プ 指定 し ます 。 
bit 15 .… 11 10 … 0807 - 0605 - 04 03 02 01 00 


・SC1 多 Screen1 Enable bit0) 
スク リー ン 1 表示 イネ ー ブ ル 。1 で スク リー ン 1 表示 。 


・SC2E Screen2 Enable( bit1) 
スク リー ン 2 表示 イネ ー ブ ル 。1 で スク リー ン 2 表示 。 


・SPR Sprite Enable( bit2) 
スプ ラバ ト 表示 イネ ー ブ ル 。1 で スプ ラバ ト 表示 。 


・SPRWH Sprite Window Enable( bit3) 
スプ ライ ト ウィ ンド ウ 機 能 イ ネー ブル 。1 で スプ ライ ト ウィ ンド ウ 機 能 有効 。 


・S2Wim Screen2 Window Mode( bit4-5) 
スク リー ン 2 ウィ ンド ウ 機 能 モ ー ド 。 00 ま た は 01 で 無効 10 で ウィ ンド ウ の 内 側 を 表示 、 11 で ウ 
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ィ ン ド ウ の 外側 を 表示 。 


・ Bordet bit8-10) 
ボー ダー カラ ー 設 定 。 0-7 の LCD カ ラー パレ ッ ト 番号 。 ボー ダー カラ ー と は 、 スク リー ン 1、 ス 
クリ ー ン 2、 スプ ライ ト の いずれ も 透明 色 だ っ た 場合 に 最終 的 に 表示 する 色 の LCD カ ラー 
パレ ッ ト 番号 で す 。 


B.1.2 画面 表示 制御 取 節 DISPLAY_STATUS ) 
男 引 数 


( な し ) 


画 機 能 詳細 
現在 の 画面 表示 状態 を 取得 し ます 。 AX に は DISPLAY_CONT ROL の BX に 指定 する 形式 
で 現在 の 設定 状態 が 得 ら れ ます 。 


B.1.3 モノ クロ キャ ラク タ 設 選 FONT_SET_MONODATA) 
男 引 数 


BX: 設定 開始 キャ ラク タ 番 号 
CX 設定 キャ ラク タ 個数 
DS : DX キャ ラク タデ ー タ アド レス 


画 戻 り 値 
( な し ) 


画 機 能 詳細 

BX で 指定 し た 番号 か ら CX 個数 分 の キャ ラク タ 群 に 、 DS : DX で 指定 し た アド レス に 格納 さ 
れ て いる 8 バイ ト キャラクタ の モノ クロ キャ ラク タデ ー タ を 設定 し ます 。 モノ クロ キャ ラク タデ ー タ の 
各 ピ ビット の うち 、 0 と な っ て いる も の は FONT_SET_COLOR で 指定 する 背景 色 に 、 1 とこ な っ て いる 
も の は 前 景色 に それ ぞ れ 展開 され ます 。 例え ば 、 00011011 と いう モノ クロ デー タ を カラ ー に 展開 
する 際 、FONT_SET_COLOR で 前 景色 を 10、 背景 色 を 00 と 指定 し て いる 場合 は 00011011 
00000000 と な り 、 前 景色 を 11、 背景 色 を 01 と 指定 し て いる 場合 は 11111111 00011011 と な り ま 
す 。 


B.1.4 カラ ー キ ャ ラク タ 設 宙 FONT_SET_COLORDATA) 
男 引 数 


BX: 設定 開始 キャ ラク タ 番 号 
CX: 設定 キャ ラク タ 個数 
102 


画面 制御 BIOS 


DS : DX: キャ ラク タデ ー タ アド レス 
画 戻 り 値 
( ん) 


画 機 能 詳細 

BX で 指定 し た 番号 か ら CX 個数 分 の キャ ラク タ 群 に 、 DS : DX で 指定 し た アド レス に 格納 さ 
れ て いる 16 バ イト キャ ラク タ の カラ ー キ ャ ラク タデ ー タ を 設定 し ます 。 カラ ー キ ャ ラク タデ ー タ は 、 各 
ライ ン 2 バイ ト で 、 上 位 バ イト に 各 ピ クセ ル の 上 位 ピ ビッ ト 、 下位 バイ 人 ト に 各 ピ クセ ル の 下位 ビット が 格 
納 され 、 対応 する ピッ ト 位置 の 2 つの ピッ ト か ら ピ クセ ル の カラ ー 番 号 を 決定 し ます 。 


上 位 バ イト 凶 下位 バイ ト 図 
7 @ 衣 43 う 210 


4 3 2 1 0 


3 
各 ピ クセ ル の カラ ー 番 号 図 


B.1.5 カラ ー キ ャ ラク タ 取 得 (FONT_GET_DATA) 
し ElE 


BX 取得 開始 キャ ラク タ 番 号 
CX 取得 キャ ラク タ 個数 
DS : DX キャ ラク タデ ー タ アド レス 


画 戻 り 値 
( ) 
還 機 能 詳細 
BX で 指定 し た 番号 か ら CX 個数 分 の キャ ラク タ 群 に つい て 、DS : DX で 指定 し た アド レス に 


16byte/ キ ャ ラク タ の カラ ー キ ャ ラク タデ ー タ を 取得 し ます 。 得 ら れる デー タ の 形式 は 、FONT_SET_ 
COLORDATA で 指定 する も の と 同様 で す 。 


B.1.6 モノ クロ フォ ント 展開 色 設 選 FONT_SET_COLOR) 
画 引 数 


BX bitO, 1: 前 景 人 多 モノ クロ フォ ント で 1 の ピク セル の 色 ) 
bit2.3: 背景 多 モノ クロ フォ ント で 0 の ピク セル の 人 色 ) 
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画 機 能 詳細 

8 バイ ト プ キ ャ ラク タ の モノ クロ フォ ント デー タ を FONT_SET_MONODATA で 展開 する 際 に 、 
各 ピ クセ ル を カラ ー 化 する た め の 人 色情 報 を 設定 し ます 。BX の 0、 1 ビッ ト に 指定 し た カラ ー が 、 モノ 
クロ フォ ント 中 で 1 と な っ て いる ピク セル に 、 また 、 2、 3 ビッ ト に 指定 し た カラ ー が 0 と な っ て いる ピク 
セル に 用 いら れ ま ず 「 B.1.3 モノ クロ キャ ラク タ 設 窟 FONT_SET_MONODATA)」 参 照 )。 文 
字 列 描画 関係 の 機能 を 利用 する 際 に 、 あらかじめ 指定 する 必要 が あり ます 。 


B.1.7 モノ クロ フォ ント 展開 色 取 委 FONT_GET_COLOR ) 
男 引 数 


( な し ) 
画 戻 り 値 


AX bit0, 1: 前 景 人 名 モノ クロ フォ ント で の 1 の ピク セル の 色 ) 
bit2.3: 背景 作 モノ クロ フォ ント で の 0 の ピク セル の 色 ) 


軒 機 能 詳細 

FONT_SET_MONODATA を 用 いて モノ クロ フォ ント を カラ ー 化 する 際 に 用 いら れる 色情 報 
を 取得 し ます 。 モノ クロ フォ ント 中 で 1 と な っ て いる ピク セル に 用 いら れる カラ ー が BX の 0、 1 ピット 
に 、 ま た 、 0 と な っ て いる ピク セル に 用 いら れる カラ ー が 2 3 ビッ ト に 、 そ れ ぞ れ 得 られ ます 。 


B.1.8 知 形 領域 キャ ラク タ 表 示 設 選 SCREEN_SET_CHAR ) 
男 引 数 


AL: 設定 する スク リー ン 0..…. ス クリ ー ン 1、1.… ス クリ ー ン 2) 
BX: 設定 領域 左上 座標 
CX 領域 の サイ ズ 


DS :DX: 表示 デー タ ア ドレ ス 
固 戻 り 値 
( な し ) 


還 機 能 詳 細 

AL で 指定 する スク リー ン の 、 BX と CX で 指定 する 知 形 領域 に 、 DS : DX で 指定 し た アド レス か 
ら 格 納 さ れ て いる 2 バイ ト キャ ラク タ の 表示 デー タ を 設定 し ます 。BL に 左側 X 座 標 、BH に 上 側 
Y 座 標 、CL に 領域 幅 、 CH に 領域 高 さ を 、 各 0 て 31 で 設定 し ます 。DS : DX か ら の 表示 デー タ 
は 、 以下 の 形式 で 左 か ら 右 、 上 か ら 下 の 順 に 並べ た も の で す 。 DS : DX は ワー ド アラ イン され て い 
た ほう が 、 実行 速度 が 速く な り ま す 。 
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bit 15 14 13 12 … 0908 … 00 


・Vmt Vertical Mirroring( bit 15) 
縦 方 向 反転 表示 。1 で 反転 。 


・Hnt Horizontal Mirroring( bit 14) 
横 方 向 反転 表示 。1 で 反転 。 


・palett& bit 9-12) 
キャ ラク タ パ レ ッ ト 番号 。 0~- 15 の キャ ラク タ パ レ ッ ト 番号 。 


・charactet bit 0-8) 
キャ ラク タ 番号 。 0 て 511 の キャ ラク タ 番号 。 


B.1.9 知 形 領域 キャ ラク タ 表 示 取 竹 SCREEN_GET_CHAR ) 
画 引 数 


AL 取得 する スク リー ン (0.… ス クリ ー ン 1、1.… ス クリ ー ン 2) 
BX: 取得 領域 左上 座標 
CX 領域 の サイ ズ 


DS :DX: 取得 デー タ ア ドレ ス 


還 機 能 詳細 

AL で 指定 する スク リー ン の 、 BX と CX で 指定 する 知 形 領域 に 設定 され て いる 表示 デー タ を 、 
DS : DX で 指定 し た アド レス か ら の パッ ファ に 2 バイ ト キャ ラク タ の バト 列 で 取得 し ます 。 BL に 左 
側 X 座 標 、BH に 上 側 Y 座 標 、CL に 領域 幅 、 CH に 領域 高 さ を 、 各 0~ こ 31 で 設定 し ます 。DS : 
DX に は 、 SCREEN_SET_CHA R で 設定 する 形式 の デー タ が 取得 され ます 。 CX に 0 を 指定 し た 
場合 、BL、 BH で 設定 され る 位置 の キャ ラク タ に 関す る 表示 デー タ の み を AX に 得 ます 。 


B.1.10 知 形 領域 キャ ラク タ 設 選 SCREEN_FILL_CHAR ) 
画 引 数 


AL: 設定 する スク リー ン 0..…. ス クリ ー ン 1、1.… ス クリ ー ン 2) 
BX: 設定 領域 左上 座標 

CX 領域 の サイ ズ 

DX: キャ ラク タ 表示 デー タ 
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画 機 能 詳細 

AL で 指定 する スク リー ン の 、 BX と CX で 指定 する 知 形 領域 に 、 DX で 指定 し た キャ ラク タ 表示 
デー タ を 設定 し ます 。BL に 左側 X 座 標 、BH に 上 側 Y 座 標 を 、 各 0~ て 31 で 指定 し ます 。 CL に 領域 
幅 、 CH に 領域 高 さ を 、 各 1 一 32 で 指定 し ます 。 DX に は SCREEN_SET_CHA R の キャ ラク タデ ー 
タ と 同じ 形式 で 設定 デー タ を 与え ます 。 スク リー ン の 知 形 領域 を 同一 の キャ ラク タデ ー タ で 埋め 尽 
くす も の で 、 全 画 面 ク リア な ど に 用 いら れ ま す 。 


B.1.11 知 形 領域 画面 属性 設 守 SCREEN_FILL_ATTR) 
男 引 数 


AL: 設定 する スク リー ン 0..…. ス クリ ー ン 1、1.… ス クリ ー ン 2) 
BX: 設定 領域 左上 座標 
CX 領域 の サイ ズ 
D 守 画面 属性 
S[ 画面 属性 の マス ク パ ター ン 
還 戻 り 値 
( な し ) 
画 機 能 詳細 


AL で 指定 する スク リー ン の 、 BX と CX で 指定 する 知 形 領域 に 、 DX と SI で 指定 し た 画面 属性 
を 設定 し ます 。 BL に 左側 X 座 標 、 BH に 上 側 Y 座 標 を 、 各 0~31 で 指定 し ます 。 CL に 領域 幅 、 CH 
に 領域 高 さ を 、 各 1 一 32 で 指定 し ます 。 DX に は SCREEN_SET_CHAR の キャ ラク タデ ー タ と 同じ 
形式 で 設定 デー タ を 与え ます 。 SI に は 現在 の 設定 値 と DX で 与え る デー タ と の 合成 を 行う た め の 
マス ク パ ター ン を 与え ます 。 

最終 的 に 設定 され る 値 は 、 以下 の よう に 計算 され ます 。 


( 現在 の 設定 値 & SI マス ク パ ター ン )! DX デー タ 


スク リー ン キ ャ ラク タフ ォ ー マ ッ ト の 一 部 分 の み を マス ク 処 理 で 変更 可能 に する も の で 、 BIOS 内 
部 で は カー ソル の 表示 用 に 用 いて いま す 。 


B.1.12 スプ ライ ト 表示 範囲 設 選 SPRITE_SET_RANGE) 


還 引 数 
BX: スプ ラバ ト 先頭 番号 
CX スプ ラバ ト 個数 
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時 機能 詳細 

画面 に 表示 する スプ ライ ト 番号 の 範囲 を 設定 し ます 。BX で 指定 する スプ ライ ト キャ ラク タ 番号 
か ら 、 CX で 指定 する 個数 分 の スプ ライ ト キャ ラク タ を 利用 可能 に し ます 。 スプ ライ ト キャ ラク タ 番号 
の 最大 値 は 12/ と な っ て いる た め 、 BX + CX は 128 以 下 で な ね く て は な り ま せん 。 実際 に スプ ライト 表 
示 を 行う 際 に は 、 DISPLAY_CONT ROL で スプ ラ 人 ト 表示 を 有効 に し て お きま す 。 


B.1.13 スプ ライ ト キャ ラク タ 設 宙 SPRITE_SET_CHAR) 
画 引 数 


BX: スプ ラ 人 ト 番号 

CX: キャ ラク タ 番号 、 表示 属性 
画 戻 り 値 

( な し ) 
画 機 能 詳細 


BX で 指定 し た 番号 の スプ ライ ト に 、 CX で 指定 し た キャ ラク タ 番号 、 表示 属性 を 設定 し ます 。 CX 
に は 、 以下 の 内 容 を ビッ トマ ッ プ 指定 し ます 。 


bit 15 14 13 12 11 … 0908 …… 00 


・Vnt Vertical Mirroring1 bit 15) 
縦 方 向 反転 表示 。1 で 反転 。 


・Hnt Horizontal Mirroring1 bit 14) 
横 方 向 反転 表示 。1 で 反転 。 


口 


・ PF Priority bit13) 
スク リー ン 2 に 対す る 優先 度 。1 で スク リー ン 2 より 優先 。 


・CE Clipping Type( bit12) 
クリ ッ ピ ング タイ プ 。1 で スプ ライ ト ウィ ンド ウ の 外側 部 分 を 表示 。 


・ palette bit 9-11) 
スプ ライ ト キャ ラク タバ パレット 番号 。 8 15 の スプ ラ 介 用 キャ ラク タ パ レ ッ ト 番号 か ら 8 を 引い た 値 。 


・charactet bit 0-8) 


キャ ラク タ 番号 。0ー 511 の キャ ラク タ 番号 。 ス プラ イト の 表示 位置 は SPRITE_SET_ 
LOCATION で 設定 し ます 。 
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B.1.14 スプ ライ ト キャ ラク タ 取 節 SPRITE_GET_CHAR) 
男 引 数 


B 光 スプ ライ ト 番号 
画 戻 り 値 

AX: 設定 状態 
画 機 能 詳 細 


BX で 指定 し た 番号 の スプ ライ ト の 、 キャ ラク タ 番号 、 表示 属性 を 取得 し ます 。 得 ら れる 設定 状 
態 は SPRITE_SET_CHA R の CX で 与え る 形式 で す 。 


B.1.15 スプ ライ ト 位置 指 居 SPRITE_SET_LOCATION) 
男 引 数 


BX: スプ ラ 人 ト 番号 
DX 表示 位置 
画 戻 り 値 
( な し ) 
画 機 能 詳細 


BX で 指定 し た 番号 の スプ ライ ト を 、 DX で 指定 し た 位置 に 表示 し ます 。 DL に X 座 標 (0 こ 255 を 、 
DH に Y 座標 (0-255) を 指定 し ます 。 表示 内 容 は SPRITE_SET_CHAR で 設定 し ます 。 


B.1.16 スプ ライ ト 表示 位置 取 筆 SPRITE_GET_LOCATION) 
男 引 数 


BX: スプ ラ 人 番号 
男 戻 り 値 

AX 表示 位置 
画 機 能 詳細 


スプ ライ ト の 表示 位置 を 取得 し ます 。 BX に スプ ラ 人 ト 番号 を 指定 し ます 。 得 られ る 表示 位置 は 
SPRITE_SET_LOCATION の DX で 与え る 形式 で す 。 


B.1.17 スプ ライ ト キャ ラク タ / 位 置 設定 
(SPRITE_SET_CHAR_LOCATION) 


還 引 数 
BXX: スプ ラバト 番号 
CX: キャ ラク タ 番号 、 表示 属性 
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DX: 表示 位置 
画 戻 り 値 

( な し ) 
還 機 能 詳 細 

スプ ライ ト の キャ ラク タ と 表示 位置 を 一 括 し て 設定 し ます 。 SPRITE_SET_CHAR と SPRITE_ 
SET_LOCATION を 同時 に 行う も の で 、 CX に は SPRITE_SET_CHAR の CX と 同じ 内 容 を 、 DX 
に は SPRITE_SET_LOCATION の DX と 同じ 内 容 を それ ぞ れ 指定 し ます 。 


B.1.18 スプ ライ ト キャ ラク タ ・ 位置 取得 
(SPRITE_GET_CHAR_LOCATION) 


画 引 数 
BXX スプ ラ 人 番号 

男 戻 り 値 
AX キャ ラク タ 番号 、 表示 属性 
DX: 表示 位置 

画 機 能 詳細 


スプ ライ ト の キャ ラク タ と 表示 位置 を 一 括 し て 所 得 し ます 。 SPRITE_GET_CHAR と SPRITE_ 
GET_LOCATION を 同時 に 行う も の で 、 AX に は SPRITE_GET_CHAR の 戻り 値 と 同じ 内 容 が 、 
DX に は SPRITE_GET_LOCATION の 戻り 値 と 同じ 内 容 が それ ぞ れ 得 られ ます 。 


B.1.19 スプ ライ ト デー タ 転送 SPRITE_SET_DATA) 
画 引 数 


BX スプ ラバ ト 先頭 番号 
CX: スプ ラバ ト 個数 
DS : DX: スプ ライ ト デー タ 
固 戻 り 値 
( な し ) 
画 機 能 詳 細 


スプ ライト 群 の キャ ラク タ 、 表示 位置 を 一 括 し て 設定 し ます 。 BX で 指定 し た 番号 か ら 、 CX 個数 
分 の スプ ライ ト キャ ラク タ 群 に 、DS : DX に 格納 され て いる スプ ライ ト デー タ を 一 括 設定 し ます 。 
DS : DX の スプ ライ ト デー タ は 、 SPRITE_SET_CHAR_LOCATION で 与え る CX、 DX の 内 容 
を 4 バイ ト の 連続 デー タ と し て 一 括 設定 する キャ ラク タ 分 並べ た も の で す 。 
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B.1.20 スク リー ンス クロ ー ル 量 設 選 SCREEN_SET_SCROLL) 
画 引 数 


AL: スク リー ツ 0.…. ス クリ ー ン 1、1.… ス クリ ー ン 2) 
BX: スク ロー ル 量 

画 戻 り 値 
( な し ) 

画 機 能 詳 細 


AL で 指定 し た スク リー ン を BX で 指定 し た 量 ス クロ ー ル し ます 。BH に Y 方 向 の スク ロー ル 量 を 、 
BL に X 方 向 の スク ロー ル 量 を 、 それ ぞ れ 絶対 指定 し ます 。 


B.1.21 スク リー ンス クロ ー ル 量 取 竹 SCREEN_GET_SCROLL) 
男 引 数 


AL: スク リー ン ( 0..…. ス クリ ー ン 1、1.… ス クリ ー ン 2) 
画 戻 り 値 

AX スク ロー ル 量 
画 機 能 詳 細 


AL で 指定 し た スク リー ン の 現在 の スク ロー ル 量 を 取得 し ます 。 AH に Y 方 向 の スク ロー ル 量 、 
AL に X 方 向 の スク ロー ル 量 が 得 ら れ ま す 。 


B.1.22 スク リー ン 2 ク リッ ピン グウィン ドウ 設 宮 SCREEN2_SET_WINDOW) 
男 引 数 


BX: スク リー ン 2 ウィ ンド ウ 左 上 座標 
CX スク リー ン 2 ウィ ンド ウサ イズ 
画 戻 り 値 
( な し ) 
画 機 能 詳 細 


スク リー ン 2 の ウィ ンド ウ 表 示 の 領域 を 設定 し ます 。 BL に ウィ ンド ウ の 左側 X 座 標 、BH に ウィ ンド 
ウ の 上 側 Y 座標 、CL に ウィ ンド ウ の 横幅 、 CH に ウィ ンド ウ の 高 さ を それ ぞ れ 指定 し ます 。 ウィ ンド 
ウ 表 示 を 行う た め に は 、 DISPLAY_CONT ROL で スク リー ン 2 の 表示 と ウィ ンド ウ 機 能 を と も に 有 
効 に し ます 。 
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B.1.23 スク リー ン 2 ク リッ ピン グウィン ドウ 取 竹 SCREEN2_GET_WINDOW) 
画 引 数 


( ) 
画 戻 り 値 
AX スク リー ン 2 ウィ ンド ウ 座標 
DX スク リー ン 2 ウィ ンド ウサ イズ 
還 機 能 詳細 


SCREEN2 の ウィ ンド ウ 表 示 の 領域 を 取得 し ます 。 AL に ウィ ンド ウ の 左側 X 座 標 、 AH に ウィ ンド 
ウ の 上 側 Y 座 標 、DL に ウィ ンド ウ の 幅 、 AH に ウィ ンド ウ の 高 さ が それ ぞ れ 得 ら れ ま す 。 


B.1.24 スプ ライ ト クリ ッ ピ ング ウィ ンド ウ 設 宣 SPRITE_SET_WINDOW) 
画 引 数 


BXX スプ ライ ト ウィ ンド ウ 左 上 座標 
CX スプ ライ ト ウィ ンド ウサ イズ 
画 戻 り 値 
( な し ) 
画 機 能 詳細 


スプ ライ ト ウィ ンド ウ 表 示 の 領域 を 設定 し ます 。 BL に ウィ ンド ウ の 左側 X 座 標 、BH に ウィ ンド ウ の 
上 側 Y 座標 、CL に ウィ ンド ウ の 横幅 、 CH に ウィ ンド ウ の 高 さ を それ ぞ れ 指定 し ます 。 ウィ ンド ウ 表 
示 を 行う た め に は 、 DISPLAY_CONT ROL で スプ ライ ト の 表示 と ウィ ンド ウ 機 能 を と も に 有効 に し 
ます 。 


B.1.25 スプ ライ ト クリ ッ ピ ング ウィ ンド ウ 取 得 SPRITE_GET_WINDOW) 
画 引 数 


( な し ) 
還 戻 り 値 
A 光 : スプ ライ ト ウィン ドウ 座標 
DX スプ ライ ト ウィ ンド ウサ イズ 
画 機 能 詳 細 


スプ ライ ト の ウィ ンド ウ 表 示 の 領域 を 取得 し ます 。 AL に ウィ ンド ウ の 左側 X 座 標 、AH に ウィ ンド 
ウ の 上 側 Y 座 標 、DL に ウィ ンド ウ の 幅 、 AH に ウィ ンド ウ の 高 さ が それ ぞ れ 得 ら れ ま す 。 
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B.1.26 キャ ラク タカ ラー 設 思 PALETTE_SET_COLOR) 
男 引 数 


BXX: キャ ラク タ パレ ッ ト 番号 
CX: 色情 報 

画 戻 り 値 
( な し ) 

画 機 能 詳細 


BX で 指定 され た キャ ラク タ パ レ ッ ト の 色情 報 を CX で 指定 し た 通り 設定 し ます 。 BX に は 、 0 か ら 
15 ま で の キャ ラク タ パ レ ッ ト 番号 を 指定 し ます 。 キャ ラク タ パ レ ッ ト の 0 か ら 7 は キャ ラク タ 専用 、 8 か ら 
15 は キャ ラク タ プス プラ イト 共用 で す 。 CX に は キャ ラク タフ ォ ン ト デー タ 00、 01、 10、 11 に 対応 する 
LCD パ レッ トカ ラー 番号 を 、 各 4 ビ ピット で 指定 し ます 。 パ レッ ト 番号 4 て 7、12-~ 15 の ビッ ト パタ ー ン 00 
は 、 無 条 件 で 0000 透明 色 ) と な り ま す 。 


B.1.27 キャ ラク タカ ラー 取 委 PALETTE_GET_COLOR ) 
男 引 数 


BXX: キャ ラク タ パレ ッ ト 番号 
画 戻 り 値 

AX: 色情 報 
画 機 能 詳細 


BX で 指定 され た キャ ラク タ パ レ ッ ト 番号 の 色情 報 を 取得 し ます 。 BX に は 、 0 か ら 15 ま で の キャ 
ラク タ パ レ ッ ト 番号 を 指定 し ます 。 キャ ラク タ パ レ ッ ト の 0 か ら 7 は キャ ラク タ 専用 、 8 か ら 15 は キャ ラク 
タス プラ イト 共用 キャ ラク タ パ レ ッ ト で す 。 AX に 得 ら れる 色情 報 の 形式 は 、CHAR_SET_ 
COLOR で 指定 する 形式 と 同様 で す 。 


B.1.28 LCD カ ラー 設 選 LCD_SET_COLOR ) 


固 引 数 
BX: LCD カ ラー パレ ッ ト 番号 000-011 に 対応 する LCD 階 調 
CX LCD カ ラー パレ ッ ト 番号 100-111 に 対応 する LCD 階 調 
固 戻 り 値 
( ん ) 
琶 機能 詳細 


BX、 CX で 指定 され た LCD カ ラー を 各 LCD カ ラー パレ ッ ト に 設定 し ます 。BX に は 、 カ ラー 番号 
000 か ら 011 ま で の LCD 階 調 を 各 4 ビ ッ ト で 指定 し ます 。 CX に は 、 カ ラー 番号 100 か ら 111 ま で の 
LCD 階 調 を 各 4 ビ ピット で 指定 し ます 。 
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B.1.29 LCD カ ラー 取 竹 LCD_GET_COLOR) 


画 引 数 
( な し ) 
画 戻 り 値 
A 光 LCD カ ラー パレ ッ ト 番号 000-011 に 対応 する LCD 階 調 
D 迷 LCD カ ラー パレ ッ ト 番号 100-111 に 対応 する LCD 階 調 
時 機能 詳細 


LCD カ ラー パレ ッ ト 番号 に 対応 する LCD カ ラー を AX、 DX に 取得 し ます 。 AX に は 、 カ ラー 番 
号 000 か ら 011 ま で の LCD 階 調 を 各 4 ビ ッ ト で 取得 し ます 。 DX に は 、 カ ラー 番号 100 か ら 111 ま で の 
LCD 階 調 を 各 4 ビ ッ ト で 取得 し ます 。 


B.1.30 LCD セ グ メ ント 表示 LCD_SET_SEGMENTS) 
画 引 数 


BX セグ メン ト 表示 デー タ 
画 戻 り 値 

( な し ) 
画 機 能 詳細 


LCD 下 部 横 位置 で 持っ た 場合 ) に 並ぶ 、 各種 マー ク の 表示 状態 を 設定 し ます 。 BX に は 以下 
の 通り 、 各 マ ー ク の 表示 状態 を 指定 し ます 。 各 ピ ビッ ト と も 、 1 で 対応 する マー ク を 表示 し ます 。 


bit 15 .… 06 05 04 03 02 01 00 
A2 

・ AS$ Aux 3 bit5) 

予備 マー ク 3 


・A42 Aux 2 bit4) 
予備 マー ク 2 


・ AT Aux 14 bit3) 
予備 マー ク 1 


・VE Vertical bit2) 
縦 モ ー ド マー ク 


・ HE Horizontal bit1) 
横 モ ー ド マー ク 
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・SI Sleep bitO) 
省 電 力 マ ー ク 


B.1.31 LCD セ グ メ ント 取 節 LCD_GET_SEGMENTS) 
男 引 数 


( な し ) 
画 戻 り 値 

AX: セグ メン ト 表示 デー タ 
画 機 能 詳 細 


LCD 下 部 横 位置 で 持っ た 場合 ) に 並ぶ 、 各種 マ ー ク の 表示 状態 を 取得 し ます 。 AX に 
LCD_GET_SEGMENT S で 指定 する 形式 で セグ メン ト 表示 状態 を 得 ます 。 


B1.32 LCB ス リー チ 設 宙 LCD_SET_SLEE 共 ) 
男 引 数 


BXX: LCD ス リー プ 状 態 
還 戻 り 値 
( な し ) 


画 機 能 詳細 
LCD の スリ ー プ 状態 を 制御 し ます 。 BX の ビッ ト 0 が 0 な ら スリ ー プ 、1 な ら スリ ー プ 解除 し ます 。 


衣 .1.33 LCD ス リー プ 取 竹 LCD_GET_SLEEP) 
男 引 数 


( な し ) 
画 戻 り 値 

AX: LCD ス リー プ 状 態 
画 機 能 詳 細 


LCD の スリ ー プ 状態 を 取得 し ます 。 AX の ビット 0 が 0 な ら スリ ー プ 、1 な ら スリ ー プ 解除 と な っ て 
いる こと を 表わし ます 。 


B.2 テキ スト 画面 BIOS 


テキ スト 画面 BIOS は 、 スク リー ン 1 また は スク リー ン 2 を 用 いて 、 テキ スト 表示 を 行う 機能 群 を 提 
供し ます 。 
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注意 : C 言 語 か ら の 呼び 出し 形式 に つい て は 、 \WWitch\include\sy s\texth を 参照 し て くだ さい 。 


B.2.1 テキ スト スク リー ン 初 期 化 TEXT_SCREEN_INIT) 
画 引 数 


( な し ) 
画 戻 り 値 

( な し ) 
画 機 能 詳 細 


スク リー ン 全体 を テキ スト 表示 用 に 初期 化し ます 。 TEXT_SET_SCREEN で テキ スト 表示 に 
いる スク リー ン を 指定 で きま す 。 


B.2.2 テキ スト ウィ ンド ウ 初 期 化 TEXT_WINDOW_INIT) 
画 引 数 


BX: ウィ ンド ウ 位 置 BL : X 座 標 , BH : Y 座 標 ) 
【@%6 ウィ ンド ウサ イズ CL : 横幅 , CH : 高 さ ) 
D 交 : 割り 当て る フォ ント テー ブル の ベー ス 

還 戻 り 値 
( な し ) 

画 機 能 詳細 


スク リー ン の 指定 し た 範囲 を テキ スト 表示 用 に 初期 化し ます 。 TEXT_SET_SCREEN で テキ 
スト 表示 に 用 いる スク リー ン を 指定 で きま す 。 


B.2.3 テキ スト 表示 モー ド 設 守 TEXT_SET_MODE) 
画 引 数 


BX 表示 モー ド 
画 戻 り 値 

( な し ) 
画 機 能 詳 細 

テキ スト 表示 モー ド を 設定 し ます 。BX に 設定 する 表示 モー ド を 、TEXT_MODE_ANK、 
TEXT_MODE_ANKSJIS、TEXT_MODE_SJIS の いずれ か で 指定 し ます 。 実際 に 表示 モー 


ド が 切り 換わる の は 、TEXT_SCREEN_INIT 、 ま た は 、TEXT_WINDOW_INIT を 実行 し た 時 
で す 。 TEXT_SET_SCREEN で テキ スト 表示 に 用 いる スク リー ン を 指定 で きま す 。 


注意 プロ グラ ム の ディ スプ レイ モー ド に よっ て 、 選択 可能 な テキ スト 表示 モー ド が 異な り ます 。 
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ディ スプ レイ モー ド TEXT_MODE_ANK TEXT_MODE_SJIS TEXT_MODE_ANKSJIS 


ASCII1 〇 O X 3 
ASCII2 〇 X 3 
日 本 語 1 ⑥) O 〇 O 
日 本 語 2 O O 〇 


注意 デイ スプ レイ モー ド は 実行 形式 に リン ク す る スタ ー ト アッ プル ー チ ン に よっ て 決定 され ます 。 lib デ ィ レ クト リ に 標 
準 で 提供 され て いる スタ ー ト アッ プル ー チ ン と ディ スプ レイ モー ド の 対応 は 以下 の 通り で す 。 


ディ スプ レイ モー ド Turbo C 用 LSI C-86 for WonderWitch 用 
ASCII1 cOwwasc1.o crtOasc1.o 
ASCII2 cOwwasc2.oD crtOasc2.o 
日 本 語 1 cOwwjpn1.obj crtOjpn1.obj 
日 本 語 2 cOwwjpn2.ob) crtOjpn2.obj 


B.2.4 テキ スト 表示 モー ド 取 委 TEXT_GET_MODE) 
男 引 数 


( な し ) 
画 戻 り 値 

AX テキ スト 表示 モー ド 
画 機 能 詳 細 


現在 設定 され て いる 表示 モー ド を 取得 し ます 。 TEXT_SET_MODE で 指定 する の と 同様 の 
値 を AX に 得 ます 。 


B.2.5 文字 描画 TEXT_PUT_CHAR) 
男 引 数 


BL,BH: 描画 位置 
CX: 文字 コー ド 


固 戻 り 値 
( な し ) 
画 機 能 詳細 


テキ スト 画面 の 指定 し た 位置 に 、 1 文字 表 示し ます 。 BL に X 位 置 、BH に Y 位置 を 、 そ れ ぞ れ 0 
て 31 の キャ ラク タ 位置 で 指定 し ます 。 CX に は 描画 する 文字 を SJIS の 文字 コー ド で 指定 し ます 。 
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B.2.6 文字 列 描画 TEXT_PUT_STRING) 
画 引 数 


BL, BH: 描画 位置 
DS :DX: 文字 列 


画 戻 り 値 

AX 描画 され た 文字 数 
画 機 能 詳細 

テキ スト 画面 の 指定 し た 位置 に 、 文字 列 を 表示 し ます 。 BL に X 位 置 、BH に Y 位置 を 、 そ れ ぞ 
れ 0~31 の キャ ラク タ 位置 で 指定 し ます 。DS : DX に 描画 する 文字 列 の 先頭 ドレ ス を 指定 し ます 。 
実際 に 描画 し た 文字 数 を AX に 取得 し ます 。 


B.2.7 部 分 文字 列 描画 TEXT_PUT_SUBSTRING) 
画 引 数 


BL,BH: テキ スト 描画 位置 
DS:DX: 文字 列 


CX 描画 バイ ト 数 
画 戻 り 値 

AX 描画 され た 文字 数 
画 機 能 詳 細 


テキ スト 画面 の 指定 し た 位置 に 、 指定 し た バイ ト 数 の 文字 列 を 表示 し ます 。BL に X 位 置 、BH 
に Y 位置 を 、 それ ぞ れ 0~31 の キャ ラク タ 位置 で 指定 し ます 。 CX に 描画 する 文字 列 の 長 さ を バイ 
ト 数 で 指定 し ます 。 DS : DX に 描画 する 文字 列 の 先頭 アド レス を 指定 し ます 。 実際 に 描画 し た 
文字 数 を AX に 取得 し ます 。 


B.2.8 数 値 描画 TEXT_PUT_NUMERIC) 


還 引 数 
BL, BH: 表示 位置 
CE 表示 桁 数 
CH フォ ー マ ッ ト 
DX: 数 値 


DS :S[: NUM_STORE で メモ リ へ 格納 する 時 の ポイ ンタ 


AX 実際 に 表示 し た 文字 数 
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画 機 能 詳細 

テキ スト 画面 の 指定 し た 位置 に 、 指定 し た フォ ー マ ッ ト で 数 値 を 表示 し ます 。 BL に X 位 置 、BH 
に Y 位置 を 、 それ ぞ れ 0~31 の キャ ラク タ 位置 で 指定 し ます 。 CX に 描画 する 文字 列 の 長 さ を バイ 
ト 数 で 指定 し ます 。 DS : DX に 描画 する 文字 列 の 先頭 アド レス を 指定 し ます 。 実際 に 描画 し た 
文字 数 を AX に 取得 し ます 。 

フォ ー マ ッ ト は 、 以下 の ピッ ト パタ ー ン の 組み 合わ せ で 指定 し ます 。 


bit シン ボル 説明 
0 NUM_HEXA 16 進 数 表記 
1 NUM_PADZERO/NUM_PADSPACE 余っ た 桁 を 埋め る 文字 1 =0、0=') 
2 _ NUM_ALIGN_LEFTINUM_ALIGN_RIGHT アラ イン メン ト ( 1 = 右 詰 、0 = 左 詰 
3 NUM_SIGNED 符号 指 坊 1 = 符号 付 、0 = 符号 無し ) 
7 NUM_STORE 出力 先 指 窟 1 = DS : S、 0= テ キス 画面 ) 


フォ ー マ ッ ト に NUM_STORE を 指定 し た 場合 に は 、DS : SI か ら の パッ ファ に 数 値 の 文字 列 
表現 を 格納 し ます 。 


B.2.9 同一 文字 複数 個 描画 (TEXT_FILL_CHAR) 
男 引 数 


BL, BH: テキ スト 描画 位置 


CX: 描画 個数 
DX: 文字 コー ド 
画 戻 り 値 
( な し ) 
画 機 能 詳細 


テキ スト 画面 の 指定 し た 位置 に 、 指定 し た 個数 、 同じ 文字 を 表示 し ます 。 BL に X 位 置 、BH に 
Y 位置 を 、 そ れ ぞ れ 0~-31 の キャ ラク タ 位置 で 指定 し ます 。 CX に 描画 する 文字 の 個数 を 指定 し ま 
す 。 DX に 描画 する 文字 の 文字 コー ド を 指定 し ます 。 


B.2.10 テキ スト パレ ッ ト 設 選 TEXT_SET_PALETTE) 
男 引 数 


B 學 キャ ラク タ パレ ッ ト 番号 
画 戻 り 値 

( な し ) 
画 機 能 詳細 


テキ スト 表示 に 用 いる 、 キャ ラク タ パ レ ッ ト 番号 を 指定 し ます 。 デフ ォ ル ト は 0 で ず 「 B.1.5 
FONT_SET_COLOR」J B.1.7 SCREEN_SET_CHA R」 参照)。 
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B.2.11 テキ スト パレ ッ ト 取 節 TEXT_GET_PALETTE) 
画 引 数 


( な し ) 
画 戻 り 値 

AX キャ ラク タ パレ ッ ト 番号 
画 機 能 詳細 


テキ スト 表示 に 用 いる 、 キャ ラク タ パ レ ッ ト 番号 を 取得 し ま ポ 「 B.29 TEXT_SET_PALETTE」 
参照 )。 


B.2.12 1 バイ ト 文字 フォ ント 設 選 TEXT_SET_ANK_FONT) 
画 引 数 


BL: 文字 コー ド ペー ス 
BH: フォ ント タイ プ 
CX フォ ント 数 


DS :DX: フォ ント デー タ 


( な し ) 


画 機 能 詳細 

1 バイ ト 文字 に 対応 する フォ ント デー タ を 設定 し ます 。 BL に 先頭 の フォ ント の 文字 コー ド を 、 BH 
に フォ ント の タイ ズ 0 モノ クロ 、1 王 カラ ー ) を 、 CX に フォ ント 数 を 、 ま た 、 DS : DX に フォ ント デー 
タ の アド レス を 指定 し ます 。 TEXT_PUT_CHA R、TEXT_PUT_ST RING、TEXT_PUT_ 
SUBST RING、TEXT_PUT_NUMERIC の 各 機 能 よ は 、 こ の 機能 に よっ て 設定 され た 文字 フォ ン 
ト を 用 いて 描画 を 行い ます 。 起動 時 は フラ ッシュ メモ リ に 格納 され て いる シス テム フォ ント が 設定 さ 
れ て いま す 。 


B.2.13 2 バイ ト 文字 フォ ント 設 選 TEXT_SET_SJ」IS_FONT) 
画 引 数 


BX : DX: フォ ント 解決 ルー チン の セグ メン ト : オ フ セ ッ ト ( BX = 0 の 場合 、 全 角 フ ォ ン ト な し ) 
還 戻 り 値 

( な し ) 
画 機 能 詳 細 

2 バイ ト 文字 に 対す る フォ ント デー タ を 解決 する ルー チン を 設定 し ます 。 フォ ント デー タ を 解決 す 


る ルー チン の 先頭 ドレ ス を BX : DX で 指定 し ます 。 フォ ント デー タ 解決 ルー チン の イン ター フェ 
イス は 以下 の 通り で す 。 
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入力 : AX SJIS 文 字 コ ー ド 
出力 : CX : SI フォ ント デー タ の アド レス 
キャ リー: ステ ー タ ズ 1 = 指定 され た 文字 コー ド に 対す る フォ ント デー タ が 見 つか ら な い ) 


B.2.14 フォ ント の 取得 (TEXT_GET_FONTDATA) 
男 引 数 


CX: 文字 コー ド 
DS : DX: フォ ント デー タ 格納 用 バッ フ メ 8 バト ) 


画 戻 り 値 


A 光 : 0=OK、 ERR_OUT_OF_BOUNDS = 不正 な 文字 コー ド 


画 機 能 詳細 

シス テム の 持つ モノ クロ フォ ント デー タ を 得 ま す 。 CX に は フォ ント デー タ を 得 た い 文 字 の 文字 コ 
ー ド を 、 DS : DX に は フォ ント デー タ を 格納 する パッ ファ へ の ポイ ンタ を それ ぞ れ 指定 し ます 。 デー タ 
の 取得 に 成功 し た 場合 に は 0 を 、 不正 な 文字 コー ド を 指定 し た 場合 に は 、ERR_OUT_OF_ 
BOUNDS を それ ぞ れ 返し ます 。 


B.2.15 テキ スト スク リー ン 選 択 TEXT_SET_SCREEN) 
男 引 数 


AL: スク リー ン 


画 機 能 詳細 

テキ スト 表示 に 用 いる スク リー ン を 設定 し ます 。 AL に スク リー ン を 0 また は 1 で 指定 し ます 。 0 が 
スク リー ン 1、1 が スク リー ン 2 で す 。 デフ ォ ル ト は ディ スプ レイ モー ド に よっ て 異な り ま す が 、 スク リー 
ン 2 を 利用 可能 な 場合 に は スク リー ン 2 に 、 そう で な けれ ば スク リー ン 1 に 設定 され て いま す 。 


B.2.16 テキ スト スク リー ン 取 節 TEXT_GET_SCREEN) 
男 引 数 


AX: スク リー ン 


還 機 能 詳細 
テキ スト 表示 に 用 いる スク リー ン を 取得 し ます 。 スク リー ン 1 を 用 いる 場合 に は 0 を 、 スク リー ン 2 
いる 場合 に は 1 を 、 それぞれ AX に 返し ます 。 


を 
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B.2.17 カー ソル 表示 ON/OFRI CURSOR_DISPLAY) 
画 引 数 


AL: カー ソル 表示 状態 
画 戻 り 値 
( な し ) 
画 機 能 詳 細 
カー ソル の 表示 ノ 非 表示 を 設定 し ます 。 AL に 1 を 設定 する と カー ソル を 表示 、 0 を 設定 する と 


非 表 示 で す 。 


B.2.18 カー ソル 状態 取 竹 CURSOR_STATUS ) 
画 引 数 


( な し ) 
還 戻 り 値 

AX カー ソル 表示 状態 
画 機 能 詳細 

カー ソル の 現在 の 表示 状態 を 取得 し ます 。 0 = OFR 非 表 示 )、1 = ON た だ し 現在 は ブリ ン 
ク 中 で 非 表示 )、 3 = ON 表示 中 ) を それ ぞ れ AX に 返し ます 。 


B.2.19 カー ソル 位置 、 サ イズ 設 守 CURSOR_SET_LOCATION) 
画 引 数 


BL, BH: X 座 標 , Y 座 標 デフ ォ ル ト で は 0 0) 
CLCH: 横幅 , 高 さ デフ ォ ルト で は 1, 1) 


画 機 能 詳細 
カー ソル の 表示 位置 、 領域 の 大 き さ を 設定 し ます 。 BL に X 座 標 、 BH に Y 座 標 、 CL に 横幅 、 CH 
こ 高 さ を 、 それ ぞ れ キャ ラク タ 単 位 で 指定 し ます 。 


B.2.20 カー ソル 位置 、 サ イズ 取 竹 CURSOR_GET_LOCATION) 
画 引 数 


( な し ) 
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画 戻 り 値 


AL,AH: X 座 標 , Y 座 標 
DL,DH: 横幅 , 高 さ 


画 機 能 詳細 
カー ソル の 表示 位置 、 領域 の 大 き さ を 取得 し ます 。 AL に X 座 標 、AH に Y 座 標 、DL に 横幅 、 
DH に 高 さ を 、 それ ぞ れ キャ ラク タ 単位 で 返し ます 。 


B.2.21 カー ソル タイ プ 設 宙 CURSOR_SET_TYPE) 
男 引 数 


BL: キャ ラク タ パレ ッ ト 番号 
(wii 点滅 周期 

画 戻 り 値 
( な し ) 

画 機 能 詳細 


カー ソル の 表示 タイ プ を 設定 し ます 。BL に カー ソル 表示 に 用 いる キャ ラク タ パ レ ッ ト 番号 を 0 て 
15 で 指定 し ます 。 デフ ォ ル ト は 1 で す 。 CL に 点滅 周期 を VBLANK 単 位 お よそ 、 1/75 秒 ) で 指定 
し ます 。 0 を 指定 する と 点滅 し ませ ん 。 デフ ォ ル ト は 30 で す 。 


B.2.22 カー ソル タイ プ 取 筆 CURSOR_GET_TYPE) 
男 引 数 


( な し ) 
画 戻 り 値 
AL: パレ ッ ト 番号 
AH: 点滅 周期 
画 機 能 詳細 


カー ソル の 表示 タイ プ を 取得 し ます 。 AL に カー ソル 表示 に 用 いる キャ ラク タ パ レ ッ ト 番号 を 返し 
ます 。 AH に 点 減 周 期 を VBLANK 単 位 で 返し ます 。 0 の 場合 に は 点滅 し て いま せん 。 


委 二 二 倒 I95 


キーBIOS は 、 WonderSwan 本 体 に 配置 され て いる ボタ ン の 押下 状態 を 取得 する 機能 群 を 提 
供し ます 。 


注意 : C 言 語 か ら の 呼び 出し 形式 に つい て は 、 \WWitch\include\sys\keyh を 参照 し て くだ さい 。 
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B.3.1 キー 状態 セン ス ( KEY_PRESS_CHECK) 


画 引 数 

( な し ) 
画 戻 り 値 

AX 各 キ ー の 押下 状態 
画 機 能 詳細 


本 体 の 11 個 の キー の 押下 状態 を セン ス し ます 。 各 キ ー の 押下 状態 を 以下 の よう に AX の 各 ビ 
ッ ト に マッ プ し ます 。 


ビッ ト 内 容 

12-15 未 使用 内 容 不定 ) 
11 Y4 横 位置 で 左 ) 
10 Y3 横 位置 で 下 ) 
9 Y2 横 位置 で 右 ) 


Y 横 位置 で 上 ) 
X4 横 位置 で 左 ) 
X3 横 位置 で 下 ) 
XZ 横 位置 で 右 ) 
X て 横 位置 で 上 ) 
B 

A 

START PAUSE ) 
未 使用 内 容 不定 ) 


の ーー DD の ドド の の ヽ OO 


念 キー 入力 チェ ッ ク ( KEY_HIT_GHECK) 


AX 各 キ ー の 入力 状況 
画 機 能 詳細 


新た に 押さ れ た キー の 一 覧 を ビッ トマ ッ プ で 得 ます 。 各 ピット と キー と の 対応 は 、KEY_PRESS_ 
CHECK と 同じ で す 。 
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B.3.3 キー 入力 待ち (KEY_WAIT) 
男 引 数 


( な し ) 
固 戻 り 値 

AX 入力 され た キー 
画 機 能 詳細 

いずれ か の キー 入力 が 行わ れる か 、 オー トリ ピー ト に よっ て ソフ トウ ェ ア 的 に キー 入力 が 発生 す 
る まで 、 HLT で 待ち ます 。 押さ れ た キー を AX に 返し ます 。 AX の 内 容 は 、 KEY_PRESS_CHECK 
と 同じ で す 。 


B.3.4 オー トリ ピー ト 設 守 KEY_SET_REPEAT) 
男 引 数 


BL: オー トリ ピー ト 間隔 デフ ォ ル ト は 4) 

BH オ - ト リピ ー- ト 開始 遅 妨 デフ ォ ル ト は 30。 0 に 設定 する と オー トリ ピー ト 無効 ) 
還 戻 り 値 

AL: 直前 の オー トリ ピー ト 間隔 設定 値 

AH: 直前 の オー トリ ビート 開始 遅延 設定 値 
画 機 能 詳細 


KEY_WAIT、KEY_HIT_CHECK_WITH_REPEAT で 入力 待ち を 行う 際 の オー トリ ピー ト 
機能 の 開始 遅延 、 間隔 を 設定 し ます 。 BL に は オー トリ ピート 開始 後 の リ ピー ト 間隔 を 指定 し ます 。 
数 値 が 大 きい ほど 、 間隔 が 長く な り ま す 。 デフ ォ ル ト は 4 で す 。BH に は オー トリ ピー ト を 開始 する まで 
の 遅延 時 間 を 指定 し ます 。 数 値 が 大 きい ほど 、 オ ー ト リピ ビー ト 開始 まで の 遅延 時 間 が 長く な り ます 。 
デフ ォ ル ト は 30 で す 。 BL、 BH に 設定 する 値 の 単位 は 、VBLANK 周 期 お よそ 1/75 秒 ) で す 。 


B.3.5 オー トリ ピー ト 取 節 KEY_GET_REPEAT ) 
男 引 数 


( な し ) 
画 戻 り 値 

AL: オ - ト リピ ビー- ト 間隔 設定 値 

AH オ - ト リピ ビー- ト 開始 遅延 設定 値 
画 機 能 詳細 


KEY_WAIT、KEY_HIT_CHECK_WITH_REPEAT で 入力 待ち を 行う 際 の オー トリ ピー ト 
機能 の 開始 遅延 、 間隔 を 取得 し ます 。 AL、 AH に 得 ら れる 値 は それ ぞ れ 、 KEY_SET_REPEAT 
で BL、 BH に 指定 する 値 と 同様 で す 。 
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B.3.6 オト リピ ビー 本 つき キー 入力 チェ ッ ズ KEY_HIT_CHECK_WITH_REPEAT) 
画 引 数 


( な し ) 
画 戻 り 値 

AX 各 キ ー の 入力 状況 
画 機 能 詳細 


オー トリ ビー ト も 考慮 し て 、 新た に 押さ れ た キー の 一 覧 を ビッ トマ ッ プ で 得 ます 。 各 ビ ピット と キー と 
の 対応 は 、 KEY_PRESS_CHECK と 同じ で す 。 


B.4 サウ ンド BIOS 
サウ ンド BIOS は 、 WonderSwan 本 体 に 搭載 され た PCM 音 源 の 制御 機能 を 提供 し ます 。 
注意 : C 言 語 か ら の 呼び 出し 形式 に つい て は 、 \WWitch\include\sy s\soundh を 参照 し て くだ さい 。 


B.4.1 サウ ンド 初期 化 SOUND_INIT) 
画 引 数 


( な し ) 
画 戻 り 値 
( な し ) 


画 機 能 詳細 
サウ ンド を すべ て オフ に し 、 波形 テー ブル も 0 クリ ア し ます 。 


B.4.2 チャ ン ネ ル 出 力 プ モー ド 設 守 SOUND_SET_CHANNEL) 
画 引 数 


BL チャ ン ネ ル 出 力 プ モー ド 設定 値 
還 戻 り 値 

( な し ) 
画 機 能 詳 細 


サウ ンド チャ ン ネ ル 1…4 の 出力 お よび モー ド を 設定 し ます 。 BL に 各 チ ャ ン ネ ル に 設定 する 内 容 
を 下 表 の ビッ トマ ッ プ パタ ー ン で 与え ます 。 


bit 内容 説明 


0 チャ ン ネ ル 1 イ ネー ブル チャ ン ネ ル 1 の 出力 を 設定 し ます 。1 の と き 出 力 し ます 
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1 チャンネル 2 イネ ー ブ ル チャ ン ネ ル 2 の 出力 を 設定 し ます 。1 の と き 出力 し ます 
チャ ン ネ ル 2 が ボイス モー ド の 場合 、 こ の ビッ ト の 指定 
は 無視 され て 必ず 出力 し ます 


2 チャ ン ネ ル 3 イ ネー ブル チャ ン ネ ル 3 の 出力 を 設定 し ます 。1 の と き 出 力 し ます 
3 チャ ン ネ ル 4 イ ネー ブル チャ ン ネ ル 4 の 出力 を 設定 し ます 。1 の と き 出 力 し ます 
4 予約 シス テム で 予約 され て いま す 。 必ず 0 を 設定 し て くだ さい 
5 チャンネル 2 モー- ド チャ ン ネ ル 2 の ボイス モー ドド を 設定 し ます 

1 の と き ボ イス モー ド に な り ま す 
6 チャン ネル 3 モー ド チャ ン ネ ル 3 の スウ ィ ー プ 機能 を 設定 し ます 

1 の と き 有効 に な り ま す 
7 チャン ネル 4 モー- ド チャ ン ネ ル 4 の ノイ ズ モ ー ド を 設定 し ます 


1 の と き ノ イズ モー ド に な り ま す 


B.4.3 チャ ン ネ ル 出 力 プ モー ド 取 筆 SOUND_GET_CHANNEL) 
男 引 数 


( し) 
還 戻 り 値 
AX チャ ン ネ ル 出 力 プ モ ー ド 設定 値 
画 機 能 詳 細 
サウ ンド チャ ン ネ ル 1-4 の 出力 状態 、 モー ド を 取得 し ます 。 AX に 得 ら れる 値 は 、 SOUND_SET 


_CHA NNEL の BX に 設定 する 値 と 同様 で す 。 


B.4.4 サウ ンド 出力 設 完 SOUND_SET_OUTPUT) 
男 引 数 


BL サウ ンド 出力 設定 
画 戻 り 値 
( な し ) 
画 機 能 詳 細 


サウ ンド の 出力 方 法 を 設定 し ます 。BL に 指定 し た 情報 に 基づい て 、 サウ ンド の 出力 先 、 本 体 
出力 時 の スケ ー リ ング を 設定 し ます 。 


bit 内容 説明 
0 本 体 モ ノラ ルス ピー カー 本 体 モノ ラル スピ ー カ ー か ら の 出力 可否 を 設定 し ます 
出力 設定 1 の と き 出 力 し ます 
2-1 本 体 モ ノラ ルス ピー カー サウ ンド 出力 デー タ 11 ビ ッ ト 中 、 本 体 モノ ラル スピ ー カ ー 
出力 スケ ー ル 設定 か ら の 出力 に 用 いる 8 ビッ ト の 領域 を 選択 し ます 
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音量 の 小さ い サ ウン ド デー タ を 大 き な ボ リュ ー ム で 出力 する 
際 に は 小さ な 値 を 、 音量 の 大 きい サウ ンド デー タ を 小さ な 
ボリ ュー ム で 出力 する 際 に は 大 き な 値 を 設定 し ます 


00 D0 て D7 を 出力 
01 D1 て D8 を 出力 
10 D2<D9 を 出力 
11 D3 て D10 を 出力 


3 外部 ヘッ ド フォ ンス テレ 外部 ヘッ ド フォ ンス テレ オ か ら の 出力 可否 を 設定 し ます 
オ 出 力 設定 1 の と き 出 力 し ます 
4-7 予約 シス テム で 予約 され て いま す 。 必ず 0 を 設定 し て くだ さい 


B.4.5 サウ ンド 出力 取 節 SOUND_GET_OUTPUT) 
画 引 数 


( な し ) 
還 戻 り 値 
AX サウ ンド 出力 設定 状態 


還 機 能 詳細 

サウ ンド 出力 の 設定 状態 、 お よび 外部 ステ レオ ヘッ ド フ ォ ン の 接続 状況 を 取得 し ます 。 AX に 返 
され る 値 は 、 SOUND_SET_OUT PUT の BX に 設定 する 値 に 、 外部 ステ レオ ヘッ ド フ ォ ン の 接続 
状況 を 加え た も の と 同様 で す 。 外部 ステ レオ ヘッ ド フ ォ ン が 接続 され て いる 場合 に 、 bit7 が 1 に な 
り ま す 。 


B.4.6 波形 設 選 SOUND_SET_WAVE ) 
画 引 数 


AL: チャ ン ネ ル 
DS :DX: 波形 デー タ ポ イン タ 


画 戻 り 値 
( な し ) 


画 機 能 詳細 

サウ ンド チャ ン ネ ル 1 一 4 の 波形 デー タ を 設定 し ます 。 AL に は 波形 デー タ を 設定 する チャ ン ネ ル 
を 0 る チャンネル] が 0. チャ ン ネ ル 2 が 1、 …) で 指定 し ます 。 DS : DX に は 設定 する 波形 デー タ の 
先頭 アド レス を 指定 し ます 。 波形 デー タ は 、 4 ビッ ト X 32 ス テッ プ 分 を 2 ステ ッ プ ノ 1 バ イト に パッ ク し 、 
16 バ イト と し た 形式 で す 。 各 バイ ト の 下位 4 ビッ ト に 偶数 ステ ッ プ 、 上 位 4 ピッ ト に 奇数 ステ ッ プ の デ 
ー タ を 格納 し ます 。 
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0 8 16 24 step 
F HHHH ロ HH 画 ロ ロロ ロロ ロロ ロロ ロロ ロロ ロロ ロロ ロロ HH ロロ HH ロロ 凶 
E HH 日 画 還 品 園 弄 ロロ ロロ ロロ HHHHHHHHHHHHHHH 隊 
DHH 還 ロロ ロロ HH 還 ロロ ロロ HHHHHHHHHHHHHHHHHH 区 
CH ロ 口 画 口 ロロ ロロ ロロ 画 口 ロロ ロロ ロロ ロロ ロロ ロロ ロロ ロロ ロロ ロロ 凶 
BHHHHHHHHHHH 玉 ロロ ロロ HHHHHHHHHHHHHHHHH 隊 
A 唱 還 ロ ロロ HHHHHHH 囲 ロロ HHHHHHHHHHHHHHHH 了 
9 ロロ HHHHH ロ HHHH ロ ロロ 画 園 口 口 ロ ロロ ロロ ロロ ロロ ロロ ロロ ロロ 図 
8 還 唱 ロロ HHHHHHHHHH ロ ロロ ロロ HHHHHHHHHHHH 区 
7 HHHHHHHHHHHHHHHH 則 ロロ ロロ HHHHHHHHH 昌 画 
6 ロロ HHHHHHHHHHHH ロ HH ロロ ロロ 画 画 口 口 ロ ロロ ロロ ロロ ロロ ロロ 隊 
5HHHHHHHHHHHHHHHHHHH 囲 ロロ ロロ HHHH 日 画 口 芝 
4 HHHHHHHHHHHHHHHHHHH ロ ロロ HHHHHHHH 区 
3 ロロ HHHHHHHHHHHHHH ロ HHH ロ ロロ 画 口 ロロ ロロ ロロ 画 口 口 較 
2HHHHHHHHHHHHHHHHHHHHHH 囲 ロロ ロロ 還 口 ロ 口 隊 
1 HHHHHHHHHHHHHHHHHHHHHH 日 画 圏 唱 固 囲 口 口 口 共 
0 ロ HHHHHHHHHHHH ロ HHHH ロ HHHHH ロ HH ロロ HH 画 ロロ ロロ ロロ 図 
vol8SACDEEFEEDCBA9987665432110112357 区 

例え ば 上 図 の よう な 波形 の 場合 、 波形 デー タ は 次 の よう に な り ま す 。 


Oxa8, Oxdc, Oxee, Oxef Oxde, Oxbc, Ox9a, Ox89, 
Ox67, Ox56, Ox34, Ox12. Ox01, Ox11, Ox32, Ox75 


B.4.7 サウ ンド 周波 数 設 選 SOUND_SET_PITCH) 
男 引 数 


AL: チャ ン ネ ル 

BX: 周波 数 
還 戻 り 値 

( な し ) 
画 機 能 詳細 

サウ ンド チャ ン ネ ル 1…4 の 出力 周波 数 を 設定 し ます 。 AL に は 周波 数 を 設定 する チャ ン ネ ル を 0 
て 3 チャ ン ネ ル 1 が 0、 チ ャ ン ネ ル 2 が 1、…) で 指定 し ます 。BX に は 下位 11 ビ ッ ト に 


SOUND_SET_WAVE で 設定 する 32 ス テッ プ の 波形 の 周波 数 を 指定 し ます 。 BX に 設定 する 値 
を N と する と 、 出力 周波 数 f は 以下 の 式 に よっ て 求め ら れ ま す 。 


f= 3.072x 106 = ((2048 - N)X 32) Hz 


チャ ン ネ ル 3 に スウ ィ ー プ モー ド が 設定 され て いる 場合 、 こ の 機能 に よっ て 設定 され る 周波 数 が 
スウ ィ ー プ 開始 時 の 初期 周波 数 と な り ま ず 「 B42 SOUND_SET_CHA NNEL」 参照)。 


B.4.8 サウ ンド 周波 数 取 節 SOUND_GET_PITCH) 
男 引 数 


AL: チャ ン ネ ル 
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AX 周波 数 


画 機 能 詳細 

サウ ンド チャ ン ネ ル 1 一 4 の 出力 周波 数 を 取得 し ます 。 AL に は 周波 数 を 取得 する チャ ン ネ ル を 0 
て 3( チ ャ ン ネ ル 1 が 0、 チ ャ ン ネ ル 2 が 1、…) で 指定 し ます 。AX に は 下位 11 ビ ッ ト に 
SOUND_SET_PITCH で 設定 する 出力 周波 数 が 得 ら れ ま す 。 


B.4.9 サウ ンド 音量 設 尾 SOUND_SET_VOLUME) 
画 引 数 


AL: チャ ン ネ ル 
BL 音量 
画 戻 り 値 
( なし) 
還 機 能 詳細 


サウ ンド チャ ン ネ ル 1 一 4 の 出力 音量 を 設定 し ます 。 AL に は 音量 を 設定 する チャ ン ネ ル を 0 て 3 
( チャ ン ネ ル 1 が 0、 チャ ン ネ ル 2 が 1、 …) で 指定 し ます 。BL に は 左右 の 出力 音量 を それ ぞ れ 4 ピッ 
ト で 指定 し ます 。 上 位 4 ピ ビット が 左 チ ャ ン ネ ル 、 下 位 4 ビ ッ ト が 右 チ ャ ン ネ ル の 出力 音量 と な り ま す 。 
チャ ン ネ ル 2 を ボイス モー ド で 利用 し て いる 際 に は 、 8 ビッ ト を すべ て 用 いて ボイス デー タ を 与え ます 。 


B.4.10 サウ ンド 音量 取 節 SOUND_GET_VOLUME ) 
画 引 数 


AL: チャ ン ネ ル 
画 戻 り 値 

AL: 出力 音量 
還 機 能 詳細 


サウ ンド チャ ン ネ ル 1 4 の 出力 音量 を 取得 し ます 。 AL に は 音量 を 取得 する チャ ン ネ ル を 0~3 
( チャ ン ネ ル 1 が 0、 チャ ン ネ ル 2 が 1、 …) で 指定 し ます 。 AL の 上 位 4 ビ デット に 左 チ ャ ン ネ ル 、 下位 4 ビ 
ッ ト に 右 チ ャ ン ネ ル の 出力 音量 が 得 ら れ ま す 。 チャ ン ネ ル 2 を ボイス モー ド で 利用 し て いる 際 に は 、 
ボイス デー タ が 得 ら れ ま す 。 


B.4.11 チャ ン ネ ル 3 ス ウィ ー プ 設 守 SOUND_SET_SWEEP ) 
画 引数 


BL: スウ ィ ー プ 値 
CE ステ ッ プ タイ バ 5 ビッ ト ) 
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画 機 能 詳細 

チャ ン ネ ル 3 の スウ ィ ー プ 機能 を 設定 し ます 。 CL の 下位 5 ビッ ト に 指定 する ステ ッ プ タイ ム ご と に チ 
ャ ン ネ ル 3 の 出力 周波 数 「 B.47 SOUND_SET_PITCH」 参照 ) に 加え る 値 を 、 -128(Ox80) か ら 
+127(Ox7F) の 範囲 で BL に 指定 し ます 。 CL に 指定 する 値 を N と する と 、 出力 周波 数 が 変化 する 
時 間 間 隔 T は 以下 の 式 に よっ て 求め られ ます 。 


=2.667 X (N+ 1) ms 


B.4.12 チャ ン ネ ル 3 ス ウィ ー プ 取 竹 SOUND_GET_SWEEP ) 
画 引 数 


( な し ) 
画 戻 り 値 
AL: スウ ィ ー プ 値 
AH: ステ ッ プ タイ ム 
画 機 能 詳 細 


チャ ン ネ ル 3 の スウ ィ ー プ 機能 の 設定 状態 を 取得 し ます 。 SOUND_SET_SWEEP で BL に 設定 
する スウ ィ ー プ 値 を AL に 、 CL に 設定 する ステ ッ プ タイ ム を AH に それ ぞ れ 返し ます 。 


B.4.13 チャ ン ネ ル 4 ノ イズ 制 衝 SOUND_SET_NOISE ) 
男 引 数 


BL ノイ ズ 制 御 値 


( な し ) 


画 機 能 詳細 
チャ ン ネ ル 4 和 を 用 いて 生成 する ノイ ズ の 種類 の 設定 、 カ ウン タ の 初期 化 、 お よび カウ ンタ の 有効 
無効 設定 を 行い ます 。 BL の 下位 5 ピッ ト に 、 以下 の 設定 値 を 指定 し ます 。 


bit 内容 説明 


2-0 ノイ ズ 選 択 ノイ ズ の 種類 を 8 種類 の 中 か ら 選 択 し ます 
ノイ ズ は 15 ビ ッ ト の ポリ ノミ カル カウ ンタ に よっ て 生成 し ます 

3 カウ ンタ リセ ッ ト ノイズ 生成 用 カウ ンタ を リセ ッ ト する ビッ ト で す 
ノイ ズ の 種類 を 変更 する 場合 に は 、 必ず 1 を 指定 し ます 

4 カウ ンタ イネ ー ブ ル ノイ ズ 生 成 用 カウ ンタ の カウ ント 動作 を 制御 する ビッ ト で す 
1 の と き に カウ ンタ が 動作 し ます 
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B.4.14 チャ ン ネ ル 4 ノ イズ 制御 取 竹 SOUND_GET_NOISE) 
画 引 数 


( な し ) 
固 戻 り 値 

A 光 ノイ ズ 制 御 値 
画 機 能 詳細 

チャ ン ネ ル 4 を 用 いて 生成 する ノイ ズ の 種類 の 設定 、 お よび カウ ンタ 動作 の 有効 無効 の 設定 
を 取得 し ます 。 SOUND_SET_NOISE の BL レジ スタ に 設定 する 値 の うち 、 カ ウン タリ セッ ト 以外 の 
設定 状態 が AX の 下位 5 ビット に 得 られ ます 。 


B.4.15 チャ ン ネ ル 4 疑 似 乱数 デー タ 取得 SOUND_GET_RANDOM) 
画 引 数 


( な し ) 
還 戻 り 値 

AX: 疑似 乱数 
画 機 能 詳細 

サウ ンド チャ ン ネ ル 4 の ノイ ズ モ ー ド で 生成 され る 擬似 乱数 を 得 ます 。 サウ ンド チャ ン ネ ル 4 の ノ 
イズ 発生 用 ポリ ノミ カル カウ ンタ の 値 を 読み 出す こと で 、 AX の 下位 15 ビ ッ ト に 擬似 乱数 を 得 ます 。 


この 機能 を 用 いる 場合 に は 、 サ ウン ド チャ ン ネ ル 4 を イネ ー ブ ル に し て お きま ず 「 B.4.2 
SOUND_SET_CHA NNEL」 参照 )。 


B.5 シリ アル 通信 BIOS 
シリ アル 通信 BIOS は 、 WonderSwan 本 体 に 搭載 され て いる 、 シ リア ル 通 信 回 線 を 制御 する 機 
能 を 提供 し ます 。 


注意 : C 言 語 か ら の 呼び 出し 形式 に つい て は 、 \WWitch\include\sy s\comm.h を 参照 し て くだ さい 。 


B.5.1 通信 開 婚 COMM_OPEN) 
画 引 数 


( な し ) 
画 戻 り 値 


( な し ) 
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画 機 能 詳細 
シリ アル 通信 機能 を 初期 化し 、 利用 開始 し ます 。 通信 速度 は COMM_SET_BAUDRATE で 
あら か じ め 指 定 し ます 。 起動 直後 は 38400bps に 設定 され て いま す 。 


B.5.2 通信 終 芝 COMM_CLOSE) 
男 引 数 


( な し ) 
還 戻 り 値 
( な し ) 


画 機 能 詳細 
シリ アル 通信 機能 を 停止 し ます 。 


B.5.3 1 バイ ト 送信 COMM_SEND_CHAR ) 


画 引 数 

BL: 送信 デー タ 
画 戻 り 値 

AX エラ ー コ ー ド ( エラ ー が な い 場 合 は 0) 
画 機 能 詳細 


BL に 与え る 1] バイト の デー タ を シリ アル 通信 回 線 に 送信 し ます 。 COMM_SET_TIMEOUT に 
よる デフ ォ ル ト の タイ ム ア ウ ト 設定 に し た が い 、 タイ ム ア ウ ト 判定 を 行い ます 。 タイ ム ア ウ ト が 発生 し た 
場合 は ERR_SIO_TIMEOUT を 返し ます 。 送信 完了 前 に キャ ン セ ル さ れ た 場合 は 、ERR_SIO_ 
CANCEL を 返し ます 。 


B.5.4 1 バイ ト 受信 COMM_RECEIVE_CHAR) 
男 引 数 


( な し ) 
固 戻 り 値 

AX 受信 デー タ ま た は エラ ー コ ー ド 
画 機 能 詳細 

シリ アル 通信 回 線 か ら 1 バイ ト 受信 し ます 。 COMM_SET_TIMEOUT に よる デフ ォ ル ト の タイ ム 
アッ ウト 設定 に し た が い 、 タイ ム ア ウ ト 判定 を 行い ます 。 タイ ム ア ウ ト が 発生 し た 場合 は ERR_SIO 


TIMEOUT を 返し ます 。 受信 完了 前 に キャ ン セ ル さ れ た 場合 は 、ERR_SIO_CA NCEL を 返し ま 
す 。 受信 デー タオ ー バ ー ラ ン が 発生 し た 場合 に は 、ERR_SIO_OVERRUN を 返し ます 。 
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B.5.5 タイ ム ア ッ ト 指定 1 バイ ト 受信 COMM_RECEIVE_WITH_TIMEOUT) 
画 引 数 


CX タイ ム ア ウ ト 値 VBLANK カ ウン ト ) 
画 戻 り 値 

AX 受信 デー タ ま た は エラ ー コ ー- ド 
画 機 能 詳 細 


タイ ム ア ウ ト を 指定 し て シリ アル 通信 回 線 か ら の 1 バイ ト 受信 を 行い ます 。 タイ ム ア ウ ト 時 間 は CX 
で 渡し ます 。 この 指定 は 、 呼び 出し 1 回 限り 有効 で 、COMM_SET_TIMEOUT に よる 設定 に は 
影響 を 与え ませ ん 。 タイ ム ア ウ ト が 発生 し た 場合 は ERR_SIO_TIMEOUT を 返し ます 。 受信 を キ 
ャ ン セ ル さ れ た 場合 は 、ERR_SIO_CANCEL を 返し ます 。 受信 デー タオ ー バ ー ラ ン が 発生 し た 場 
合 に は 、ERR_SIO_OVERRUN を 返し ます 。 


B.5.6 文字 列 送信 COMM_SEND_STRING) 
画 引 数 


DS :DX: 送信 文字 列 ポイ ンタ 
還 戻 り 値 

AX エラ ー コ ー ド ( エラ ー が な い 場合 は 0) 
画 機 能 詳細 

DS : DX か ら 格納 され て いる Ox00 で 終端 する 文字 列 を シリ アル 通信 回 線 に 送信 し ます 。 
COMM_SET_TIMEOUT に よる デフ ォ ル ト の タイ ム ア ウ ト 設定 に し た が い 、 1 文字 ご と に タイ ム ア ウ 
ト 判定 を 行い ます 。 タイ ム ア ウ ト が 発生 し た 場合 は ERR_SIO_TIMEOUT を 返し ます 。 送信 完了 
前 に キャ ン セ ル さ れ た 場合 は 、ERR_SIO_CA NCEL を 返し ます 。 


B.5.7 ブロ ッ ク 送 信 COMM_SEND_BLOCK ) 


画 引 数 

DS :DX: 送信 デー タ ポ イン タ 

C 迷 デー タ サ イズ 
画 戻 り 値 

AX: エラ ー コ ー ド ( エラ ー が な い 場 合 は 0) 
画 機 能 詳細 


DS : DX か ら 格納 され て いる CX で 指定 する 長 さ の バイ ナリ デー タ を シリ アル 通信 回 線 に 送信 し 
ます 。 COMM_SET_TIMEOUT に よる デフ ォ ル ト の タイ ム ア ウ ト 設定 に し た が い 、 各 バ イト ご と に 
タイ ム ア ッ ウト 判定 を 行い ます 。 タイ ム ア ウ ト が 発生 し た 場合 は ERR_SIO_TIMEOUT を 返し ます 。 送 
信 完 了 前 に キャ ン セ ル さ れ た 場合 は 、ERR_SIO_CA NCEL を 返し ます 。 
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B.5.8 ブロ ッ ク 受 信 COMM_RECEIVE_BLOCK) 
画 引 数 


DS : DX: 受信 バッ ファ ポイ ンタ 


CX 受信 バッ ファ サイ ズ 
画 戻 り 値 

AX エラ ー ヨ ー ド 

DX 受信 バト 数 
画 機 能 詳細 


DS : DX か ら 確 保 さ れ て いる デー タバ パッ ファ に 、 CX で 指定 する バト 数 シリ アル 通信 回 線 か ら 受 
信 し 、 実際 に 受信 され た バイ ト 数 を DX に 返し ます 。 COMM_SET_TIMEOUT に よる デフ ォ ル ト 
の タイ ム ア ウ ト 設定 に し た が い 、 各 バ イト ご と に タイ ム ア ウ ト 判定 を 行い ます 。 タイ ム ア ウ ト が 発生 し た 
場合 は 、、AX に ERR_SIO_TIMEOUT を 返し ます 。 送信 完了 前 に キャ ン セ ル さ れ た 場合 は 、AX 
に ERR_SIO_CA NCEL を 返し ます 。 


B.5.9 タイ ム ア ウ ト 設 選 COMM_SET_TIMEOUT ) 
男 引 数 


B 學 受信 タイ ム ア ウ ト 時 間 VBLANK カ ウン ト 、 0 = 即 返る 、 -1 = 待ち 続け き デフ ォ ル ト )) 
CX 送信 タイ ム ア ウ ト 時 間 

画 戻 り 値 
( な し ) 

画 機 能 詳細 


シリ アル 送受 信 機 能 の デフ ォ ル ト タイ ム ア ウ ト 値 を 設定 し ます 。BX に 受信 時 の タイ ム ア ウ ト 時 間 、 
CX に 送信 時 の タイ ム ア ウ ト 時 間 を 、 それ ぞ れ VBLA NK カ ウン ト の 値 で 与え ます 。 0 を 指定 し た 場 
合 は 、 ま っ た く 待た ず に 即時 実行 で き な け れ ば タイ ム ア ウ ト し ます 。 また 、 -1 を 指定 する と 、 無期 限 
で 送受 信 完 了 を 待ち ます 。 初期 値 は -] と な っ て いま す 。 タイ ム ア ウ ト は 1 バト 送受 信 ご と に 、 カ ウン 
ト さ れ ま す 。 し た が っ て 、 複数 バイ ト の 送受 信 に お いて トー タル の タイ ム ア ウ ト 時 間 を 設定 し た い 場 
合 は 、V BLA NK カ ウン ト 値 を 参照 し て ユー ザ レ ベル で タイ ム ア ウ ト 判定 する 必要 が あり ます 。 


B.5.10 通信 ボー レー ト 設 完 COMM_SET_BAUDRATE) 
男 引 数 


BXX: 通信 速度 0= 9600、1 = 3840G デフ ォ ル ト )) 
画 戻 り 値 


( な し ) 
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画 機 能 詳細 

シリ アル 通信 回 線 の 通信 速度 を 設定 し ます 。 通信 回 線 を 利用 中 で あっ て も 、 こ の 機能 に より 通 
信 速 度 を 変更 する こと が で きま す 。 この 機能 で 設定 し た 通信 速度 は 、 BIOS 設 定 と し て 保存 され 、 
次 回 起動 する と き に も 有効 と な り ます 。 


B.5.11 通信 ボー レー ト 取 節 COMM_GET_BAUDRATE) 
画 引 数 


( な し ) 
画 戻 り 値 

A 光 通信 速度 (0 = 9600、1 = 38400) 
画 機 能 詳細 


シリ アル 通信 回 線 の 通信 速度 を 取得 し ます 。 9600bps に 設定 され て いる 場合 は 0、 38400bps 
に 設定 され て いる 場合 は 1 を 、 それぞれ 返し ます 。 


B.5.12 通信 キャ ン セ ルキ ー パ ター ン 設 定 COMM_SET_CANCEL_KEY) 
画 引 数 


B キャ ン セ ルキ ー パ ター ン 
還 戻 り 値 

AXX: キャ ン セ ルキ ー パ ター ン 
画 機 能 詳 細 


通信 を キャ ン セ ル す る キー の パタ ー ン を 設定 し ます 。 BX に は 、 KEY_PRESS_CHECK で 得 ら 
れる も の と 同様 な キー の ビット マップ パタ ー ン を 指定 し ます 。 0 を 指定 する と 、 ど の キー を 押し た 場 
合 で も 通信 を キャ ン セ ル し ます 。 


B.5.13 通信 キャ ン セ ルキ ー パ ター ン 取 得 COMM_GET_CANCEL_KEY) 
画 引 数 


( な し ) 


AX: キャ ン セ ルキ ー パ ター ン 
置 機能 詳細 


通信 を キャ ン セ ル す る キー の パタ ー ン を 取得 し ます 。 AX に は 、 COMM_SET_CANCEL_KEY 
で 設定 し た パタ ー ン が 得 ら れ ま す 。 
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B.5.14 XMODEM 送 受信 COMM_XMODE M) 
男 引 数 


DS : BX: xmodeminfo_t 構 造 体 へ の ポイ ンタ 
還 戻 り 値 
AX: プロ トコ ル の 乱 移 状 態 ま た は エラ ー コ - ド 


画 機 能 詳細 
xmodeminfo {構造 体 を 用 いて 、 XMODEM プ ロト コル に よる バイ ナリ 送受 信 を 行い ます 。 


注意 シス テム が 利用 する 機能 の た め 、 ユー ザ プ ロ グラ ム か ら 利用 し た 場合 の 動作 は 保証 され て いま せん 。 


B.6 タイ マカ レン ダ BIOS 


タイ マブ カ レン ダ BIOS は 、 WonderWitch 専 用 カー トリ ッ ジ に 搭載 され て いる カレ ンダ 時 計 の 制 
御 機能 を 提供 し ます 。 


注意 : C 言 語 か ら の 呼び 出し 形式 に つい て は 、 \WWitch\include\sys\timerh を 参照 し て くだ さい 。 


B.6.1 RTC リ セッ ト ( RTC_RESET) 
画 引 数 


( を し) 
還 戻 り 値 
( を し) 
画 機 能 詳 細 
カセ ッ ト に 内 蔵 され て いる RT Real Time Clock) を リセ ッ ト し ます 。 通常 、 こ の 機能 は 出荷 


後 一 度 だ け 実 行 され ます 。 この 機能 は シス テム が 利用 する も の な の で 、 ユー ザ プ ロ グラ ム は 呼び 
出し て は いけ ませ ん 。 


B.6.2 RTC 日 付 時 間 取 竹 RTC_GET_DATETIME) 
男 引 数 


BX: 返す 値 の 種類 
画 戻 り 値 

AX 値 
還 機 能 詳細 


RTC が 保持 し て いる 現在 日 付 時 刻 の 指定 し た フィ ー ル ド の 値 を 取得 し ます 。 BX に 値 を 取得 す 
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る べき フィ ー ル ド を 以下 の と お り 指 定 し ます 。 


BX シン ボル 取得 する フィ ー ル ド 

0 RTC_YEAR 往 2000 年 を 0 と する ) 
1 RTC_MONTH 月 

用 RTC_DATE 日 

3 RTC_DAY_OF_WEEK 曜日 

4 RTC_HOUR 時 24 時 間 制 ) 

5 RTC_MIN 分 

6 RTC_SEC 秒 


B.6.3 RTC 日 付 時 間 設 選 RTC_SET_DATETIME) 
画 引 数 


BX: 設定 する 値 の 種類 
CX 値 
画 戻 り 値 
( し) 
還 機 能 詳細 


RTC に 日 付 や 時 刻 を 設定 し ます 。BX に 値 を 設定 する べき フィ ー ル ド を 、 CX に 設定 する 値 を 、 
それ ぞ れ 指定 し ます 。BX に 指定 する 値 は 、RTC_GET_DATETIME と 同様 で す 。 


B.6.4 RTC 日 付 時 間 一 括 設 選 RTC_SET_DATETIME_STRUCT ) 
画 引 数 


DS :DX: gatetime_t 構 造 体 へ の ポイ ンタ 
画 戻 り 値 
( な し ) 
画 機 能 詳細 
RTC に 日 付 時 刻 を 一 括 設 定 し ます 。 DS : DX に 設定 する べき 日 付 時 刻 を 保持 し た datetime 


_t 構 造 体 へ の ポイ ンタ を 指定 し ます 。 
datetime_t 構 造 体 は 、 以下 の よう に 宣言 され ます 。 


typedefF s ヒ と エ uc 七 { 
BYTEE 立 Ga エ : 
BYTE mon モ h: 
BYTE da 上 @: 
BYTE day_oF_week : 
BYTE hou エ : 
BYTE minu モ @: 
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BYTE second: 
} date も me_ 七 : 


B.6.5 RTC 日 付 時 間 一 括 取 竹 RTC_GET_DATETIME_STRUCT) 
男 引 数 


DS : DX: datetime_t 構 造 体 へ の ポイ ンタ 
画 戻 り 値 

( な し ) 
画 機 能 詳細 

RTC か ら 日 付 時 刻 を 一 括 取 得 し ます 。 DS : DX に 取得 し た 日 付 時 刻 を 格納 する べき datetime 
_t 構 造 体 へ の ポイ ンタ を 指定 し ます 。 


B.6.6 RTC ア ラー ム 割 り 込み 設 選 RTC_ENABLE_ALARM) 
男 引 数 


BL: アラ ー ム 時 00 て 23) 
BH: アラ ー ム 祭 00 て 59) 
画 戻 り 値 
( な し ) 
画 機 能 詳 細 


RTC に アラ ー ム 時 刻 を 設定 し ます 。BL に 時 間 を 24 時 間 制 0 か ら 23) で 、 BH に 分 を 指定 し ま 
す 。 この 機能 で 設定 し た 時 刻 に な る と 、RTC が 割り 込み を 発生 させ 、 カ セッ ト か ら の 割り 込み が 
発生 し ます 。 カセ ッ ト 割り 込み 発生 時 の コー ル パ ッ クル ー チ ン は 、 SYS_INTERRUPT_SET_HOOK 
を 用 いて 設定 し ます 。 


B.6.7 RTC 割 り 込 み 解 際 RTC_DISABLE_ALARM) 
男 引 数 


( な し ) 


画 機 能 詳細 
RTC に 設定 され て いる アラ ー ム を 解除 し ます 。 
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B.6.8 タイ マー 割り 込み 設 選 TIMER_ENABLE) 
画 引 数 


AL: タイ マー タイ プ 
BL: オー- 下 プリ セッ ト ON/OFF 
6 プリ セッ ト カウ ンタ 値 
画 戻 り 値 
( な し ) 
画 機 能 詳細 


WonderSwan 本 体 の タイ マー 割り 込み を 設定 し ます 。 AL に 設定 する タイ マー の タイ プ を TIMER_ 
HBLA NK(0 ま た は TIMER_VBLA NK(1) で 、 BL に オー ト プ リ セッ ト を 行う か どう か を TIMER_ONE 
SHOT (0 また は TIMER_AUTOPRESET (1) で 、 CX に プリ セッ トカ ウン タ 値 を 、 そ れ ぞ れ 指 定 し ま 
す 。 TIMER_AUTOPRESET を 用 いる と 、 カ ウン タ の 値 が 0 に な っ た 場合 に 、 自動 的 に プリ セッ ト 
カウ ンタ 値 に 再 設定 され ます 。 TIMER_ONESHOT を 用 いる と 、 カウ ンタ の 値 は 0 に な っ て も 再 設 
定 は され ませ ん 。 タイ マー 割り 込み 発生 時 の コー ル バ ッ クル ー チ ン は 、 SYS_INTERRUPT_SET 
HOOK を 用 いて 設定 し ます 。 


B.6.9 タイ マー 割り 込み 禁 四 TIMER_DISABLE) 
画 引 数 


AL タイ マー タイ プ 
画 戻 り 値 

( な し ) 
画 機 能 詳細 


指定 し た タイ プ の タイ マー 割り 込み を 禁止 し ます 。 AL に 割り 込み を 禁止 する タイ マー の タイ プ を 
TIMER_HBLA NK(0 ま た は TIMER_VBLANK(1) で 指定 し ます 。 


B.6.10 タイ マー カウ ント 値 取 委 TIMER_GET_COUNT) 
画 引 数 


AL: タイ マー タイ プ 
画 戻 り 値 

A 光 : 現在 の カウ ンタ 値 
画 機 能 詳細 


指定 し た タイ プ の タイ マー カウ ンタ の 現在 値 を 取得 し ます 。 AL に カウ ンタ 値 を 取得 する タイ マー 
の タイ プ を TIMER_HBLA NK(0 ひ また は TIMER_VBLANK(1) で 指定 し ます 。 
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B.7 シス テム 制御 BIOS 


シス テム 制御 BIOS は 、 割り 込み ハン ドラ の 設定 や 、 サス ペン ド プリ ジュ ー ム 制御 な ど と いっ た シ 
ステ ム 関 連 の 機能 を 提供 し ます 。 


注意 : C 言 語 か ら の 呼び 出し 形式 に つい て は 、 \W Witch\include\sys\sy stemh を 参照 し て くだ さい 。 
注意 : シス テム 制御 BIOS は シス テム が 使用 する た め 、 ユー ザ プ ロ グラ ム で の 使用 を 想定 し て いな い 機 能 が 含ま 
れ て いま す 。 


B.7.1 割り 込み フッ クセ ッ ト ( SYS_INTERRUPT_SET_HOOK ) 
男 引 数 


AL: 割り 込み 要因 0 = 送信 、1 = キー、 .……7=H blank timer) 
DS : BX: 割り 込み ハン ドラ 構造 体 へ の ポイ ンタ 
DS :DX: 以前 の 設定 の 取得 DX = 0 の 場合 、 取得 し な い .… 手 抜き 用 ) 


( な し ) 


画 機 能 詳細 

AL で 指定 する 割り 込み 要因 の 割り 込み ハン ドラ と し て 、 DS : BX が 指す 構造 体 に 格納 され て いる 
コー ルツ や ク 関 数 と 、 そ の コー ル / ツ や ク 関 数 を 実行 する 際 に 設定 すべ き DS を 与え ます 。 以前 の 設定 
状態 を DS : DX が 指す 構造 体 に 返し ます 。 DX が 0 の 場合 は 、 以前 の 設定 状態 は 返し ませ ん 。 

AL に は 、 割り 込み 要因 毎 に 以下 の 値 を 指定 し ます 。 


AL シン ボル 説明 
0 SYS_INT_SENDREADY シリ アル 送信 デー タ エ ン プティ 
1 SYS_INT_KEY キー 割り 込み 
2 SYS_INT_CASETTE カセ ッ ト 割り 込み 
3 SYS_INT_RECEIVEREADY シリ アル 受信 デー タレ ディ ー 
4 SYS_INT_DISPLINE 描画 ライ ン 番号 検知 割り 込み 
5 SYS_INT_VBLANK_COUNTUP VBLANK タ イマ ー カ ウン ト 終了 
6 SYS_INT_VBLANK VBLANK 期 間 開 始 
7 SYS_INT_HBLANK_COUNTUP HBLANK タ イマ ー カ ウン ト 終了 


コー ルル バッ ク 関 数 と 呼び 出し 時 の DS を 設定 取得 する intvector_t 構 造 体 は 、 以下 の よう に 定 
義 さ れ ま す 。 


S 七 エ uC 七 ユエ mn 七 で ら C モ or_ 七 { 
Yo1d near (*oa11baok) () : 
word GS: 
word ds: 


WO エ Q| エエ GSG エ VG : 
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callback に は コー ルツ ッ ク 関数 の オフ セッ ト 値 を 、cs に は コー ルック 関数 の セグ メン ト 値 を 、 ま 
た 、 ds に は コー ルツ ッ ク 関 数 を 呼び 出す 際 に DS に 設定 すべ き セ グ メ ント 値 を 指定 し ます 。 


注意 : SYS_INT_CASETTE は 、 RTC か ら の アラ ー ム 割り 込み で 利用 され る の で 、 設 定 す る と アラ ー ム 機能 が 正 
し く 動 作 し な く な る 場合 が あり ます 。 


B.7.2 割り 込み フッ クリ セッ ト ( SYS_INTERRUPT_RESET_HOOK ) 
画 引 数 


AL: 割り 込み 要因 
DS :BX: 以前 の 設定 の 構造 体 へ の ポイ ンタ BX = 0 の 場合 、 0 クリ ア ) 


画 戻 り 値 
( な し ) 
画 機 能 詳細 
AL で 指定 する 割り 込み 要因 に 対す る 割り 込み ハン ドラ を 元 の 設定 に 戻し ます 。DS : BX が 


指す 割り 込み ハン ドラ 構造 体 に 、SYS_INTERRUPT_SET_HOOK で DS : DX に 取得 し た 設 
定 状態 を 渡し 、 以前 の 状態 に 戻し ます 。 BX が 0 の 場合 に は 、 割り 込み ハン ドラ を クリ ア し ます 。 


B.7.3 一 定時 間 ウ ェ イ ト ( SYS_WAIT) 
画 引 数 


C 燃 ウェ イト 時 間 VBLANK 単 位 : 75 で 約 1 秒 ) 
画 戻 り 値 
( な し ) 
画 機 能 詳細 
指定 し た 時 間 、 実行 を 停止 し ます 。 CX に 実行 を 停止 する 時 間 の 長 さ を VBLA NK カ ウン ト 数 


で 指定 し ます 。 な お 、VBLA NK は 75 カ ウン ト で 約 1 秒 に 相当 し ます 。 


注意 : 実際 に は BIOS の オー バー ヘッ ド で 誤差 が 出 ます 。 


B.7.4 スリ ー プ 時 間 設 守 SYS_SET_SLEEP_TIME ) 
画 引 数 


BL: スリ ー プ モー ド 開始 時 間 単位 : 分 、0=OFF) 
画 戻 り 値 


( な し ) 
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画 機 能 詳細 
無 操 作 時 、 ス リー プ モ ー ド に 入る まで の 時 間 を 設定 し ます 。 BL に スリ ー プ モー ド に 入る まで の 
時 間 を 分 単位 で 指定 し ます 。 BL に 0 を 指定 する と 、 スリ ー プ モー ド に 入り ませ ん 。 


B.7.5 スリ ー プ 時 間 取 筆 SYS_GET_SLEEP_TIME ) 
男 引 数 


( な し ) 
画 戻 り 値 
AX: スリ ー プ モー ボド 開始 時 間 
画 機 能 詳 細 
無 操作 時 、 スリ ー プ モー ド に 入る まで の 時 間 を 取得 し ます 。 SYS_SET_SLEEP_TIME で 設定 


し た 分 単位 の 時 間 を 返し ます 。 


B.7.6 シス テム カウ ンタ 取 節 SYS_GET_TICK_COUNT) 
男 引 数 


( な し ) 
画 戻 り 値 
DX :AX: 起動 か ら の 経過 時 間 


還 機 能 詳細 
起動 時 か ら の 経過 時 間 を 取得 し ます 。 VBLA NK の 32 ビ ピッ トカ ウン ト 値 を DX : AX に 得 ます 。 


EZ77。、 スリ ー プ (SYS_SLEP) 
男 引 数 


( を ) 
還 戻 り 値 
( を ) 
画 機 能 詳 細 
LCD 画 面 の 表示 を オフ に し 、 スリ ー プ モー ド に 入り ます 。 SYS_SET_AWAKE_KEY に よっ て 


設定 され た キー パタ ー ン を 押下 する こと で 、 スリ ー プ モー ド を 抜け ます 。 


B.7.8 スリ ー プ 解除 キ 一 設 選 SYS_SET_AWAKE_KEY ) 
男 引 数 


BXX: キー パタ ー ン 
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画 機 能 詳 細 

スリ ー プ 状態 を 解除 する た め の キ ー パ ター ン を 設定 し ます 。 BX に スリ ー プ 状態 を 解除 する た 
め の キ ー パ ター ン を 、 KEY_PRESS_CHECK の 戻り 値 で 得 ら れる 形式 で 指定 し ます 。 0 を 指定 す 
る と 、 い ずれ の キー で も スリ ー プ を 解除 し ます 。 


B.7.9 スリ ー プ 解除 キ 一 取 竹 SYS_GET_AWAKE_KEY) 
画 引 数 


AX: キー パタ ー ン 


画 機 能 詳細 

スリ ー プ 状態 を 解除 する た め の キ ー パ ター ン を 取得 し ます 。 スリ ー プ 状態 を 解除 する た め の キ 
ー パ ター ン を 、 KEY_PRESS_CHECK と 同じ 形式 で 取得 し ます 。 戻り 値 が 0 の 場合 に は 、 い ずれ 
の キー で も スリ ー プ を 解除 し ます 。 


B.7.10 スリ ー プ 中 有効 割り 込み 設 志 SYS_GET_KEEPALIVE_INT) 
画 引 数 


BL: 割り 込み 許可 フラ グ 
画 戻 り 値 

( な し ) 
画 機 能 詳細 


スリ ー プ 中 も 有効 と な る 割り 込み 要因 を 設定 し ます 。 BL に スリ ー プ 中 に も 有効 と な る 割り こみ 
要因 群 を 、 以下 の ビッ トマ ッ プ パタ ー ン で 設定 し ます 。 


説明 


ど : 
3 


シリ アル 送信 デー タ エ ン プティ 
キー 割り 込み 

カセ ッ ト 割り 込み 

シリ アル 受信 デー タレ ディ ー 
描画 ライ ン 番号 検知 割り 込み 
VBLANK タ イマ ー カ ウン ト 終了 
VBLANK 期 間 開始 
HBLANK タ イマ ー カ ウン ト 終了 


っ へい の ROD 一 の 
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デフ ォ ル ト で は キー 割り 込み の み が 有 効 で す 。 


B.7.11 所 有 者 情報 取 委 SYS_GET_OWNERINFO) 
男 引 数 


CX 構造 体 の サイ ズ 
DS:DX: 取得 する 構造 体 の ポイ ンタ 


画 戻 り 値 

AX: 0=OK、ERR_SIO_TIMEOUT = シリ アル ROM リ ー ド エラ ー 
画 機 能 詳細 

WonderSwan 本 体 に 記録 され て いる 所 有 者 情報 を 取得 し ます 。 DS : DX に は 、 ownerinfo t 構 
造 体 へ の ポイ ンタ を 指定 し ます 。 


SS ヒエ uC 七 owner1nfFo 七 { 


char name[16]: // 名 前 

in 七 。 わ ュ Eh ea エ : // 西暦 その まま 

Char birth_monh: // エー ュ 2 

Cha エ わ ュ て Eh_day: // ユマ ョ 1 

Cha 了 SG: / / 0=?, 1=ma1e, 2=Fema1e 
Char b1oodD@: / / 0=?, 1 ユ =A, 2=B, 3=O, 4=AB 


} : 


名 前 は アス キー コー ド 、 た だ し ハー ト と 音符 は A NK フ ォ ン ト の コー ド が 返り ます 。 名 前 が 16 文 字 
の 場合 は 0 で 終わ ら な い の で 注意 が 必要 で す 。 CX に 与え る 値 を struct onwerinfo t の サイ ズ よ り 
小さ くす る こと で 、 取得 する 情報 を 限定 で きま す 。 例え ば CX = 16 と すれ ば 、 名 前 の み が 取 得 で き 
ます 。 


B.7.12 実行 状態 保 究 SYS_SUSPEND) 
男 引 数 


AL: コア イメ ー ジ 番号 
DS : BX: 10 ポー 下 テー ブル 


還 戻 り 値 
AX: 0= 保 存 完了 、1 = サス ペン ド 状態 か ら 復 帰 
画 機 能 詳細 


本 体内 蔵 RAM す べ て と |I/O ポ ー ト テー ブル で 指定 し た 1/O ボ ー ト 群 の 現在 の 状態 を SRA M に 
保存 し ます 。 SYS_RESUME、 SYS_SWAP を 利用 し て 実行 状態 を 復元 し ます 。 


注意 シス テム が 利用 する 機能 の た め 、 ユ ー ザ プロ グラ ム か ら 利用 し た 場合 の 動作 は 保証 され ませ ん 。 
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正常 に 保存 を 行っ た あと 、 AX に 0 を 設定 し て 一 旦 制御 を 呼び 出し 元 に 戻し ます 。 保存 され て 
いる 状態 が 復元 され た 場合 、 ま た は 指定 され た コア イメ ー ジ 番号 が 既に 利用 中 の 場合 は 、AX に 
は 0 以外 の 値 を 返し ます 。 

DS : BX の テー ブル は 、 先頭 の | ワー ド が ' 1O" か どう か で 有効 な ポイ ンタ か どう か を 判定 し ます 。 
その 後ろ に 続く OEOh 個 の 値 で 、 各 ポ ー ト の 状態 を 保存 する か どう が 0= 保存 し な い 、 1 = 保存 
する ) を 指定 し ます 。 

テー ブル の far ポ イン タ は 、 SRA M 内 に 保存 され ます の で 、 RESUME 時 に は 渡す 必要 は あり ま 
せん 。 


B.7.13 実行 状態 復 世 SYS_RESUME ) 
画 引 数 


AL: コア イメ ー ジ 番号 


( な し ) 


画 機 能 詳細 
SRAM に 保存 され て いる 、 本体 内蔵 RAM す べ て と I/O ボ ポー ト 群 の 状態 を 復元 し ます 。 SYS_ 
SUSPEND を 利用 し て 実行 状態 を 保存 し ます 。 


注意 シス テム が 利用 する 機能 の た め 、 ユ ー ザ プロ グラ ム か ら 利用 し た 場合 の 動作 は 保証 され ませ ん 。 


正常 に 状態 が 復元 され た 場合 、 SYS_SUSPEND の 呼び 出し 元 に 制御 が 戻り ます 。 指定 され 
た コア イメ ー ジ 番号 に サス ペン ド 情報 が 保存 され て いな い 場 合 に は 、 呼び 出し 元 に 制御 が 戻り ます 。 


B.7.14 リモ ー ト モー ド 設 守 SYS_SET_REMOTE) 
画 引 数 


AL 0 = リモ ー ト モー を 解除 、1 = リモ - 下 モー- ド を 設定 
画 戻 り 値 
( な し ) 


画 機 能 詳細 
リモ ー ト モニ タモ ー ド を 設定 し ます 。 


注意 シス テム 内 部 で 利用 され る 機能 の た め 、 ユー ザ は 直接 呼び 出し て は いけ ませ ん 。 


B.7.15 り モ ー ト モー ド 取 往 SYS_GET_REMOTE) 
画 引 数 


( な し ) 
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A 0 = リモ ー ト モー ド は 設定 され て いな い 、1 = リモ ー ト モー ド が 設定 され て いる 


画 機 能 詳細 
リモ ー ト モニ タモ ー ド が 設定 され て いる か どう か を 取得 し ます 。 


注意 シス テム 内 部 で 利用 され る 機能 の た め 、 ユー ザ は 直接 呼び 出し て は いけ ませ ん 。 


B.7.16 内 蔵 RAM ワ ー ク エリ ア 確 便 SYS_ALLOC_IRAM) 
男 引 数 


B 光 ポイ ンタ を 格納 する アド レズ 0=CS の 値 と ペア で BIOS 内 部 の 管理 領域 へ 格納 ) 
CX 要求 サイ ズ 

画 戻 り 値 
AX 確保 され た 領域 の 先頭 アド レズ 空き 領域 が 足り な い 場 合 は 0) 

還 機 能 詳細 


要求 する サイ ズ の ワー クエ リア を 本 体内 蔵 RA M 上 に 確保 し ます 。 常駐 IL な ど 、 SRA M 上 に ワ 
ー ク エリ ア を 確保 する こと が で き な い プロ グラ ム 用 で 、 通常 の プロ グラ ム が この 機能 を 利用 する こ 
と は あり ませ ん 。 


B.7.17 内 蔵 RAM ワ ー ク エリ ア 解 放 SYS_FREE_IRAM) 
男 引 数 


BX: 解放 する 領域 の アド レス 
画 戻 り 値 
( な し ) 
画 機 能 詳 細 
SYS_ALLOC_IRA M で 確保 し た 領域 を 解放 し ます 。 常駐 IL な ど 、 SRA M 上 に ワー クエ リア を 


確保 する こと が で き な い プロ グラ ム 用 で 、 通常 の プロ グラ ム が この 機能 を 利用 する こと は あり ませ 
ん 。 


B.7.18 内 蔵 RAM ワ ー ク エリ ア 参 照 SYS_GET_MY_IRAM) 
男 引 数 


( な し ) 
圏 戻り 値 
AX 確保 され て いる 領域 の 先頭 ドレ ズ 確保 され て いな い 場合 は 0) 
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画 機 能 詳細 

SYS_ALLOC_IRA M に よっ て 確保 され て いる 領域 の 先頭 アド レス を AX に 取得 し ます 。 領域 
が 確保 され て いな い 場合 に は 、 0 を 返し ます 。 常駐 IL な ど 、 SRA M 上 に ワー クエ リア を 確保 する こ 
と が で き な い プロ グラ ム 用 で 、 通常 の プロ グラ ム が この 機能 を 利用 する こと は あり ませ ん 。 


B.7.19 BIOS バ ー ジ ョ ン 取 節 SYS_GET_VERSION) 
画 引 数 


( な し ) 
還 戻 り 値 

AX: ヴァ ー ジ ョ ン 情報 
画 機 能 詳細 

BIOS の ヴァ ー ジ ョ ン 情報 を 取得 し ます 。 AX レジ スタ の 上 位 ビ ピット か ら 、 メジ ャ ー4 ビ ピッ ト 、 マイ ナ 
ー4 ピ ビット 、 サブ マイ ナー 8 ピット の 情報 が 返り ます 。 


B.7.20 実行 状態 入替 SYS_SWAP ) 


画 引数 

AL: コア イメ ー ジ 番号 
画 戻 り 値 

AX 0 正常 復帰 、0 = 指定 され た コア イメ ー ジ 番号 の デー タ が 存在 し な い 
画 機 能 詳 細 


SRA M に 保存 され て いる サス ペン ド 情報 本 体内 蔵 RAM す べ て と |I/O ボ ー ト 群 の 状態 ) と 、 現 
在 の 実行 状態 を 交換 し ます 。 SYS_SUSPEND、 ま た は SYS_SWAP 自 体 を 利用 し て 実行 状態 を 
保存 し ます 。 


注意 シス テム が 利用 する 機能 の た め 、 ユーザ プロ グラ ム か ら 利用 し た 場合 の 動作 は 保証 され ませ ん 。 


正常 に 状態 が 復元 され た 場合 、 保存 され て いた 実行 状態 の SYS_SUSPEND、 SYS_SWAP 
の 呼び 出し 元 に 制御 が 戻り ます 。 指定 され た コア イメ ー ジ 番号 に サス ペン ド 情報 が 保存 され て い 
な い 場合 に は 、 呼び 出し 元 に 制御 が 戻り ます 。 


B.7.21 サス ペン ド 情報 保存 状態 取 竹 SYS_GET_RESUME ) 
画 引 数 


( な し ) 
圏 戻り 値 
AX サス ペン ド 情報 保存 状態 
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画 機 能 詳細 
サス ペン ド 情報 保存 状態 を 取得 し ます 。 SYS_SUSPEND、 SYS_SWAP を 利用 し て 保存 され 
て いる サス ペン ド 情報 が 存在 する か どう か を AX の 上 位 8 ビ ッ ト に 得 ます 。 


注意 シス テム が 利用 する 機能 の た め 、 ユーザ プロ グラ ム か ら 利用 し た 場合 の 動作 は 保証 され ませ ん 。 


B.7.22 サス ペン ド 情報 保存 状態 設 守 SYS_SET_RESUME ) 
男 引 数 


BX: サス ペン ド 情報 保存 状態 
男 戻 り 値 
( し) 
画 機 能 詳 細 


サス ペン ド 情報 保存 状態 を 設定 し ます 。 SYS_GET_RESUME で 参照 され る サス ペン ド 情報 の 
保存 状態 を 、BX に 指定 し た 値 に 設定 し ます 。 


注意 シス テム が 利用 する 機能 の た め 、 ユーザ プロ グラ ム か ら 利用 し た 場合 の 動作 は 保証 され ませ ん 。 


B.8 バン ク 制 御 BIOS 


WonderWitch 専 用 カー トリ ッ ジ 上 の フラ ッシュ メモ リ と SRA M を アク セス する 際 に 、 CPU メモ リ 
空間 の 特定 領域 に マッ ピン グ す る 必要 が ある 場合 が あり ます 。 バン ク 制 御 BIOS は この マッ ピン グ 
を バン ク 切 り 替え に よっ て 行う 機能 を 提供 し ます 。 また 、 バン ク 切 り 替 え を 意識 せ ず に メモ リ 内 容 
を 読み 書き する 機能 も 提供 し ます 。 


注意 : C 言 語 か ら の 呼び 出し 形式 に つい て は 、 \WWitch\include\sys\bank.h を 参照 し て くだ さい 。 
注意 バンク 制 御 BIOS 機 能 群 は と ステ ム が 利用 する も の の た め 、 ユー ザ プ ロ グラ ム か ら 利用 し た 場合 の 動作 は 
保証 され て いま せん 。 


B.8.1 バン クマ ッ ピ ング 設 選 BANK_SET_MAP ) 
画 引 数 


BL バン ク の 種類 
(@ が 6 バン ク 番号 
画 戻 り 値 
( な し ) 
画 機 能 詳細 


各 バ ンク へ 、 メ モリ バン ク を マッ プ し ます 。 BL に 割り 当て を 行う バン ク の 種類 を 、 BANK_SRA M、 
BANK_ROM0、 BA NK_ROM 1 の いずれ か で 指定 し ます 。 CX に は 割り 当て る メモ リバ ンク の 番 
号 を 指定 し ます 。V ersion 1 の カセ ッ ト に お いて 有効 な メモ リバ ンク 番号 は 、 SRA M の 場合 0 て 3、 
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フラ ッシュ メモ リ の 場合 0-7 で す 。 


B.8.2 バン クマ ッ ピ ング 取 委 BANK_GET_MAP ) 
画 引 数 


BL バン ク の 種類 
画 戻 り 値 

AX バン ク 番号 
画 機 能 詳細 


各 バ ンク へ の 割り 当て られ て いる メモ リバ ンク 番号 を 取得 し ます 。BL に 取得 し た い バ ンク の 種 
類 を 、 BANK_SRAM、 BANK_ROM0、 BANK_ROM1 の いずれ か で 指定 し ます 。 


B.8.3 バン ク 指 定 1 バイ ト 読み 込み BANK_READ_BYTE) 
画 引 数 


BX: バン ク 指定 値 

DX バン ク 内 の オフ セッ ト 
囲 戻り 値 

AL: デー タ 
置 機能 詳 細 


昌 定 し た メモ リバ ンク の 、 指定 し た 位置 の メモ リ 内 容 を 1 バイ ト 読み 込み ます 。BX に メモ リ 内 容 
を 読み 込み た い メ モリ バン ク を 、 DX に バン ク 内 の オフ セッ ト を 指定 し ます 。 BX に 与え る 値 は 、 下 
位 15 ビ ッ ト で メモ リバ ンク 番号 を 、 最上 位 1 ビッ ト で SRA M/ フ ラッ シュ メモ リ の 種別 1 な ら ば フラ ッ 
シュ メモ リ ) を 指定 し ます 。 


B.8.4 バン ク 指 定 1 バイ ト 書き 込み BANK_WRITE_BYTE) 
画 引 数 


BX: バン ク 指定 値 
D 交 : バン ク 内 の オフ セッ ト 
(1 デー タ 
囲 戻り 値 
( を し) 
置 機能 詳細 


旧 定 し た メモ リバ ンク の 指定 し た 位置 に 1 バイ ト の デー タ を 書き 込み ます 。BX に デー タ を 書き 込 
みた い メ モリ バン ク を 、 DX に バンク 内 の オフ セッ ト を 、 CL に 書き 込む デー タ を 、 それぞれ 指定 し ま 
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す 。 BX に 与え る 値 は 、 下位 15 ビ ッ ト で メモ リバ ンク 番号 を 、 最上 位 1 ビッ ト で SRA M/ フ ラッ シュ メモ 
リ の 種別 1 な ら ば フラ ッシュ メモ リ ) を 指定 し ます 。 フラ ッシュ メモ リ に デー タ を 書き 込む 際 に は 、 あ 
ら か じ め そ の メモ リバ ンク を 消去 し て お きま す 。 


B.8.5 バン ク 指 定 1 ワー ド 読み 込 の が BANK_READ_WORD) 
男 引 数 


BX: バン ク 指定 値 

DX: バン ク 内 の オフ セッ ト 
固 戻 り 値 

AX: デー タ 
琶 機能 詳細 


指定 し た メモ リバ ンク の 、 指定 し た 位置 の メモ リ 内 容 を 1 ワー ド 読み 込み ます 。 BX に メモ リ 内 容 
を 読み 込み た い メ モリ バン ク を 、 DX に バン ク 内 の オフ セッ ト を 指定 し ます 。 BX に 与え る 値 は 、 下 
位 15 ビ ッ ト で メモ リバ ンク 番号 を 、 最上 位 1 ビッ ト で SRA M / フ ラッ シュ メモ リ の 種 串 1 な ら ば フラ ッ 
シュ メモ リ ) を 指定 し ます 。 


B.8.6 バン ク 指 定 1 ワ ー ド 書き 込み が BANK_WRITE_WORD) 
男 引 数 


BX: バン ク 指定 値 
DX バン ク 内 の オフ セッ ト 
CXX: デー タ 
還 戻 り 値 
( な し ) 
軒 機 能 詳細 


指定 し た メモ リバ ンク の 、 指定 し た 位置 に 1 ワー ド の デー タ を 書き 込み ます 。BX に デー タ を 書き 
込み た い メ モリ バン ク を 、 DX に バンク 内 の オフ セッ ト を 、 CX に 書き 込む デー タ を 、 それ ぞ れ 指定 し 
ます 。 BX に 与え る 値 は 、 下位 15 ビ ッ ト で メモ リバ ンク 番号 を 、 最上 位 1 ビッ ト で SRA M/ フ ラッ シュ メ 
モリ の 種別 1 な ら ば フラ ッシュ メモ リ ) を 指定 し ます 。 フラ ッシュ メモ リ に デー タ を 書き 込む 際 に は 、 
あら か じ めそ の メモ リバ ンク を 消去 し て お きま す 。 


B.8.7 バン ク 指 定 ブ ロッ ク 読 み 込 が BANK_READ_BLOCK ) 
男 引 数 


BX: バン ク 指定 値 

CX: ブロ ッ ク サ イズ 

DX: バン ク 内 の オフ セッ ト 

DS :SI: 読み 込む バッ ファ の ポイ ンタ 
還 戻 り 値 

( な し ) 
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画 機 能 詳細 

指定 し た メモ リバ ンク の 指定 し た 位置 の メモ リ 内 容 を 、 指定 し た 長 さ の バッ ファ に 読み 込み ま 
す 。 BX に メモ リ 内 容 を 読み 込み た い メ モリ バン ク を 、 CX に 読み 込む ブロ ッ ク の 長 さ を 、 DX に バン 
ク 内 の オフ セッ ト を 、 DS : SI に パッ ファ の ポイ ンタ を 、 それ ぞ れ 指定 し ます 。 BX に 与え る 値 は 、 下位 
15 ビ ピット で メモ リバ ンク 番号 を 、 最上 位 1 ビッ ト で SRA M / フ ラッ シュ メモ リ の 種別 1 な ら ば フラ ッシュ 
メモ リ ) を 指定 し ます 。 バ ンク 境界 を また が る よう な ブロ ッ ク を 指定 する と 、 バン ク 境界 で 折り 返し 
ます 。 


B.8.8 バン ク 指 定 ブ ロッ ク 書き 込み BANK_WRITE_BLOCK ) 
画 引 数 


BX: バン ク 指定 値 

CX: ブロ ッ ク サ イズ 

DX バン ク 内 の オフ セッ ト 

DS : SI 書き こむ バッ ファ の ポイ ンタ 
囲 戻り 値 

( を し) 
置 機能 詳細 


指定 し た メモ リバ ンク の 指定 し た 位置 に 、 指定 し た 長 さ の バッ ファ か ら 書き 込み ます 。BX に メ 
モリ 内 容 を 書き 込み た い メ モリ バン ク を 、 CX に 書き 込む ブロ ッ ク の 長 さ を 、 DX に バン ク 内 の オフ 
セッ ト を 、 DS : SI に パッ ファ の ポイ ンタ を 、 それ ぞ れ 指定 し ます 。BX に 与え る 値 は 、 下位 15 ビ ピッ ト 
で メモ リバ ンク 番号 を 、 最上 位 1 ビッ ト で SRA M/ フ ラッ シュ メモ リ の 種別 1 な ら ば フラ ッシュ メモ リ ) 
を 指定 し ます 。 バ ンク 境界 を また が る よう な ブロ ッ ク を 指定 する と 、 バン ク 境界 で 折り 返し ます 。 


B.8.9 バン ク 指 定 ブ ロッ ク フ ィ ル ( BANK_FILL_BLOCK ) 
画 引 数 


BX: バン ク 指定 値 
C 光 : ブロ ッ ク サ イズ 0 = 64KB 全 部 ) 
DX: バン ク 内 の オフ セッ ト 
AL: フィ ル デ ー タ 
圏 戻り 値 
( を し) 
時 機能 詳細 


指定 し た メモ リバ ンク の 指定 し た ブロ ッ ク を 、1 バ イト の デー タ で 埋め 尽く し ます 。BX に 埋め 尽く 
し た い メ モリ バン ク を 、 CX に 埋め 尽く す ブ ロッ ク の 長 さ を 、 DX に ブロ ッ ク の バン ク 内 で の オフ セッ 
ト を 、 AL に 埋め 尽く す デ ー タ を 、 それ ぞ れ 指定 し ます 。BX に 与え る 値 は 、 下位 15 ビ ッ ト で メモ リ 
バン ク 番 号 を 、 最上 位 1 ビッ ト で SRA M/ フ ラッ シュ メモ リ の 種別 1 な ら ば フラ ッシュ メモ リ ) を 指定 し 
ます 。 バ ンク 境界 を また が る よう な ブロ ッ ク を 指定 する と 、 バン ク 境界 で 折り 返し ます 。 
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C.1 ファ イル 形式 変換 ツー ル ( mkfent) 


C.1.1 概要 

WonderWitch は XMODEM プ ロト コル を 用 いて ファ イル を や り 取 りす る 際 、 先頭 の 1] ブロック 
( 128 バ イト ) に 、 フ ァイル 名 や 、 ファ イル 情報 、 ブ ロッ ク 数 、 ファ イル モー ド な どの 各種 情報 を 盛り 込 
み ま す 。 これ ら の 情報 が 盛り 込ま れ た ファ イル 形式 が WonderWitch 転 送 形 式 で す 。 mkfent コ マ 
ンド は 、 通常 の ファ イル を WonderWitch 転 送 形式 に 変換 し ます 。 


C.1.2 動作 環境 

mkfent.exe は 32 ビ ッ ト ア プリ ケー ショ ン で す 。 Windows 98/NT /2000 の MS-DOS プ ロン プ ト で 動 
作 し ます 。 DOS 環 境 で は 、 mkfent16exe を 利用 くだ さい 。 

mkfent.exe は 、Visual C++ 60 で コン パイ ル し て いま す 。 mkfent16exe は 、Turbo C 201 
( 英語 版 ) で コン パイ ル し て いま す 。 


C.1.3 コマ ンド ライ ン 書 式 
mkfent コ マン ドラ イン 書式 は 次 の 通り で す 。 


USage: mkfent 情報 ファ イル 
また は 


USage: mkfent f フ ァイル 


1 番目 の 書式 で は 、 情報 ファ イル に 基づい て ファ イル 形式 を 変換 し ます 。 2 番目 の 書式 で は 、 デ 
フォ ルト の 設定 に 基づい て 、 フ ァイル 形式 を 変換 し ます 。 

情報 ファ イル に は 、 ファ イル 形式 変換 に 用 いる mkfent 情 報 ファ イル を 指定 し ます 。 mkfent 情 報 
ファ イル .cf フ ァイル ) に は 、 WonderWitch 転 送 形 式 に 盛り 込む 情報 を 1 行 に つき 1 項目 ずつ 、 


タグ : 値 


と いう 書式 で 記述 し ます 。 有効 な タグ と 指定 する 値 の 内 容 は 以下 の 通り で す 。 


name: ファ イル 名 (ASCII16 文 字 まで ) 

info: ファ イル の 説明 (ASCII24 文 字 ま で ) 

mode: ファ イル モー ド を 表す シン ボル 、 また は 、 4 桁 の 16 進 数 
x- 実行 可能 
w- 書き 込み 可能 
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『- 読み 出し 可能 
m- MMAP 禁 止 
s- スト リー ム IL 
に イン ダイ レク トラ イブ ラリ 
に シン ボリ ッ ク リ ンク 
d- ディ レク トリ 
resource: 連結 する リソー ズ 空白 ま た は タブ で 区 切っ て リソー ス フ ァ イル を 列挙 ) 
aDDid: ファ イル の 種別 8 桁 の 16 進 数 ) 
source: 入力 ファ イル 変換 前 の ファ イル ) 
output: 出力 ファ イル 変換 後 の フ ァイル ) 


オプ ショ ン に より 、 デフ ォ ル ト 設定 に 基づい て ファ イル 変換 する 場合 に は 、 次 の よう に 指定 し た 
場合 と 同様 に 変換 が 行わ れ ます 。 


name: ファ イル 名 
info: ファ イル 名 
mode: rw 


resource: 指定 な し 
appid: 指定 な し 


C.2 ビッ トマ ッ プ 変換 ツー ル ( bmpcnv ) 


C.2.1 概要 
bmpcnv は 、 白黒 また は 256 色 の Windows BMP ファ イル を 、 WonderWitch 上 で 表示 可能 な 
リソー ス フ ァ イル バイ ナリ ) 、 また は 、 C 言 語 の ソー ス フ ァ イル に 変換 する ツー ル で す 。 


C.2.2 変換 可能 な BMP ファ イル の 形式 


・ 白黒 また は 256 人 実際 に 使用 し て いる 色 は 4 色 ) 

・256 色 の 場合 は 、 白 、 黒 、 グ レー2 色 、 また は 白 、 黒 、 グ レー、 背景 色 
・RGB の 各 値 が 異な る 色 を 、 背景 色 と 識 別 

・4 色 より 多い 色 数 が 使わ れ て いる 場合 の 動作 は 未定 

・ パ レッ ト の 配置 は 自由 

・ BMP の 横幅 & 高 さ は 、8 の 倍数 

・ 横幅 & 高 さ は どちら も 204 ボ ッ ト 未満 、 デー タ サ イズ は 64KB 未 満 


C.2.3 動作 環境 

bmpcnv.exe は 32bit ア プリ で す 。Windows 98/NT /2000 の MS-DOS プ ロン プ ト で 動作 し ま 
す 。 DOS 環 境 で は 、 bmpcnv 16exe を 利用 くだ さい 。 bmpcnv.exe は 、Visual C++ 60 で コン パ 
イル し て いま す 。 bmpcnv16exe は 、 Turbo C 20{ 英語 版 ) で コン パイ ル し て いま す 。 


C.2.4 コマ ンド ライ ン 書 式 
bmpcnv コ マン ド の コマ ンド ライ ン 書式 は 以下 の 通り で す 。 


usage: bmpcnv オプ ショ ン BMP ファ イル [ リソー ス フ ァ イル 名 ] 
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また は 


usage: bmpcnv -tE フォ ー マ ッ ト フ ァイル ] BMP ファ イル C ソ ー ス ファ イル 名 ] 


1 番目 の 書式 で は 、 BMP ファ イル を リソー ス 形 式 の ファ イル ファ イル ) に 変換 し まず リソー ス 
モー ド )。 2 番目 の 書式 で は 、BMP フ ァイル を C 言 語 の ソー ス 形 式 に 変換 し まず C ソ ー ス モー ド 、 
後述 )。 

リソー ス フ ァ イル 名 、 C ソ ー ス ファ イル 名 に は 出力 先 の ファ イル 名 を 指定 し ます 。 これ ら の 指定 を 
省略 し た 場合 、 リソース ファ イル 名 は BMP ファ イル 名 の 拡張 子 ぞ "fr" に し た も の 、 C ソ ー ス ファ イル 
名 は BMP ファ イル 名 の 拡張 子 だ を ”.h" と し た も の と な り ま す 。 リソー スモ ー ド で は 、 以下 の オプ ショ 
ン が 有効 で す 。 


-t<type> リソー スタ イプ を 英字 2 文字 で 指定 し まず デフ ォ ル ト ば " BM") 
-d<id> リソー ス ID を 10 進数 で 指定 し まず デフ ォ ル ト は 0) 
-@ WonderWitch 転 送 形式 の ファ イル を 出力 し ます 


C.2.5 出力 デー タフ ォ ー マ ッ ト 

出力 デー タ は 、 8< ボッ ト を 1 フォ ント と みな し た WonderSwan の フォ ント デー タ で す 。 リソー スモ 
ー ド の 場合 に は 、 先頭 に 16 バ イト の リソー ス ヘ ッ ダ を 付加 し ます 。 詳細 は 、 \W Witch\include\ 
resource.h を 参照 し て くだ さい 。 


C.2.6 C ソ ー ス モー ド ( -c オ プシ ョ ン ) 

C で イン クル ー ド 可能 な ソー ス フ ァ イル 形式 で デー タ を 出力 し ます て "に 続く ファ イル 名 は 、 ソ ー 
ス フ ァ イル の 先頭 部 に 書き 出さ れる 内 容 を 定義 し 6 て お く フ ァイル で す 。 ファ イル 名 を 省略 し た 場合 
は 、 カ レン ト レク トリ の ' format "が 指定 され た も の と し ます 。 


例え ば 、 上 の よう な グラ フィ ッ ク デ ー タ を 持つ BMP ファ イル を smile.bmp と し て 用 意 し 、 format と 
いう ファ イル に 


#deFine も s_width %qd 
#deFine も s_heigh モ %d 


unsiqgned $s bmp_ も s[] = { 


と 記述 し て 、 bmpcnv て format smilejbmp と 実行 する と 、 smile.h フ ァイル に 以下 の 結果 が 得 
られ ます 。 


#deFine smi1e width 4 
#deFine smi1e_height 4 


uns1qgned shor モ 上 bmp_smi1e[] = { 
0x0000, Ox0000, Ox0101, 0x0302, Ox0704, OxOFO08, Ox1F10, 
0x3F20, ... 
} : 
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C.3 演奏 デー タ 変換 ツー ル ( sndcnv) 


C.3.1 概要 
sndcnv は 、 以下 の 演奏 デー タ を サウ ンド ドラ イ バ SoundIL ) が 演奏 可能 な リソー ス フ ァ イル に 
変換 する ツー ル で す 。 


・BGM シ ー ケ ンス デー 人 MML テ キス ト : * .mml) 

・ 効果 音 シ ー ケ ンス デー タダ MML テ キス ト : * .mml) 

・ 音源 デー タダ 音源 テキ スト : * .prg) 

・ PCM ボ イス デー Windows wave フ ァイル : ※* .wav) 


C.3.2 動作 環境 

sndcnv.exe は 32 ビ デット アプ リケーション で す 。 Windows 98/NT /2000 の MSDOS プ ロン プ ト で 動 
作 し ます 。 DOS 環 境 で は 、 sndcnv 16exe を ご 利用 くだ さい 。 

sndcnv.exe は 、Visual C++ 60 で コン パイ ル し て いま す 。 sndcnv16exe は 、Turbo C 201 
( 英語 版 ) で コン パイ ル し て いま す 。 


C.3.3 コマ ンド ライ ン 書式 
sndcnv コ マン ド の コマ ンド ライ ン 書式 は 次 の 通り で す 。 


usage: sndcnv [| オプション] シー ケン ス デ ー タ * .mml) リソー ス フ ァ イル 名 ] 
また は 

usage: sndcnV -i [オプ ショ ン ] 音源 デー タ * .prg) リソー ス フ ァ イル 名 ] 

また は 


usage: Sndcnv -w [| オプション] wave フ ァイル * .wav) | リソース フ ァイル 名 ] 


1 番目 の 書式 で は 、MMI Music Macro Language) で 記述 され た シー ケン ス デ ー タ を 、 リ 
ソー ス 形 式 の ファ イル fr ファ イル ) に 変換 し ます 。 2 番目 の 書式 で は 、 テ キス ト で 記述 され た 音源 
デー タ を 変換 し ます 。 3 番目 の 書式 で は 、 wave フ ァイル を 変換 し ます 。 変換 可能 な wave フ ォ ー マ 
ッ ト は 、 8 ビッ ト モノ ラル の み で す 。 サン プリ ング レー ト は 、 約 12KHz で す 。 

リソー ス フ ァ イル 名 に は 出力 先 の ファ イル 名 を 指定 し ます 。 指定 を 省略 し た 場合 、 演奏 デー タ ま 
た は 音源 デー タ の ファ イル 名 の 拡張 子 を fr に し た も の と な り ま す 。 


オプ ショ ン に は 次 の も の を 指定 で きま す 。 


-b く n> 効果 音 リソー ス に 変換 し ます ( n= 効 果 音 の 最大 数 、 省略 時 1) 

-S アセ ン ブ ラ の ソー ス フ ァ イル ( .asm) を 出力 し ます 

-t ぐ type 之 リソー スタ イプ を 英字 2 文字 で 指定 し まず ポ BGM、 効果 音 、 音源 、 ボイス の デ 
フォ ルト は それ ぞ わ " MD"、 SE"、 SFP、 VO") 

-d ぐ id 之 リソー ス ID を 10 進 数 で 指定 し まず デフ ォ ル ト は 0) 

-e WonderWitch 転 送 形式 の ファ イル を 出力 し ます 
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Weydie fe 


。 付録 D 


その 他 の 仕様 


D.1 リモ ー ト シェ ル 通 信 プ ロト コル 仕様 


D.1.1 物理 層 
RS232C 


Ri デー タリ ンタ 眉 


speed 38400/9600bps 
data 8 ビッ ト 

parity な し 

stop bit 1 

フロ ー 制 御 な し 

同期 調歩 同期 非同期 ) 


D.1.3 ネッ トワ ー ク 必 
( な し ) 
D.1.4 トラ ンス ポー ト 層 


・ 無 手順 : コマ ンド リク エス ト 、 レ スポ ンス 
・XMODEM: ファ イル 転送 


D.1.5 セション 必 
園 コ マン ド 
・stty 


stty [ く SP> マ 設定 ] べ 改行 > 


端末 モー ド の 設定 。 < 設定 シ パ ラメ ー タ が 無い と き は 現在 の 状態 を テキ スト デー タ で 返す 。 イ 
ンタ ラク ティ ブ モ ー ド に 切り 替わる と 、 以後 レス ポン スコ ー ド 送信 後に プロ ンプ ト を 表示 する 。 起動 


時 の デフ ォ ル ト は ノン イン タラ クティ ブ モ ー ド 。 


パラ メー タ : 


設定 メ echo: イン タラ クティ ブ モ ー ド ( エコ ー モ ー ド )、 -echo: ノン イン タラ クティ ブ モ ー ド ) 
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レス ポン スコ ー ド : 

125 STARTING コマ ンド は 受け 付け られ た 。 転送 を 開始 する ) 
451 LOCAL ERR コマ ンド を 中 断 し た 。 ロー カル エラ ー ) 

502 NOT IMPLEMENTE コマ ンド は 実装 され て いな い ) 


504 NOT IMPLEMENTE コマ ンド の パラ メー タ が 実装 され て いな い ) 


200 OK( コマ ンド は 成功 し た ) 


て 改行 > 


端末 ‥ モ ー ド を イン タラ クティ ブ モ ー ド に 設定 。 イン タラ クティ ブ モ ー ド に 切り 替わる と 、 以後 レス ポ 


ンス コー ド 送信 後に プロ ンプ ト を 表示 する 。 起動 時 の デフ ォ ル ト は ノン イン タラ クティ ブ モ ー ド 。 


レス ポン スコ ー ド : 
451 LOCAL ERR コマ ンド を 中 断 し た 。 ロー カル エラ ー ) 
502 NOT IMPLEMENTE コマ ンド は 実装 され て いな い ) 
200 OK( コマ ンド は 成功 し た ) 

・HELO 
HELO [ <SP> 挨拶 >] 改行 > 


挨拶 する 。 返事 の 挨拶 を テキ スト デー タ で 返す 。 


パラ メー タ : 
挨拶 文字 列 ) 


レス ポン スコ ー ド : 

125 STARTING コマ ンド は 受け 付け られ た 。 転送 を 開始 する ) 
451 LOCAL ERR( コマ ンド を 中 断 し た 。 ロー カル エラ ー ) 

502 NOT IMPLEMENTE コマ ンド は 実装 され て いな い ) 

200 OK( コマ ンド は 成功 し た ) 


・ put 


put [ <SP ツ > ご 絶対 パス ディ レク トリ 名 >] ご 改行 > 


指定 し た 絶対 パス ギ イ レク トリ 名 の ディ レク トリ 上 に XMODEM で ファ イル を 送り 込む 。 受信 側 で 


受信 確認 し な い 。 


パラ メー タ : 


絶対 パス ディ レク トリ 名 /fom0 ま た は /from0/ ハー ド ファ イル シス テム #O、/fam0 ま た は 
/ ル am0/ ソフ ト フ ァイル シス テム 0O、 省略 され た 場合 カレ ント デ 


ィ レ クト リ ) 
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レス ポン スコ ー ド : 

350 FURTHER INFOG コマ ンド は 受け 付け られ た 。 情報 を 待っ て いる ) 
426 TRANSFER ABOTEE 転送 が 中 断 し た ) 

450 NOT AVAILABLEK ファ イル が 使用 不能 ) 

451 LOCAL ERR コマ ンド を 中 断 し た 。 ロー カル エラ ー ) 

452 FS FULI( ファ イル シス テム が 満杯 ) 

502 NOT IMPLEMENTEE コマ ンド は 実装 され て いな い ) 

504 NOT IMPLEMENTE コマ ンド の パラ メー タ が 実装 され て いな い ) 
550 NOT AVAILABLE ファ イル が 使用 不能 ) 

200 OK コマ ンド は 成功 し た ) 


・send 
send [ <SP>> 絶対 パス ディ レク トリ 名 >] 改行 > 


指定 し た 絶対 パス ディ レク トリ 名 の ディ レク トリ 上 に XMODEM で ファ イル を 送り 込む 。 受信 側 で 
受信 確認 を 行う 。 


パラ メー タ : 

絶対 パス ディ レク トリ 名 /om0 ま た は /rom0/ ハー ド ファ イル シス テム #O、/am0 ま た は 
人 am0/ ソフ ト フ ァイル シス テム が 0O、 省略 され た 場合 カレ ント デ 
ィ レ クト リ ) 


レス ポン スコ ー ド : 

350 FURTHER INFO コマ ンド は 受け 付け られ た 。 情報 を 待っ て いる ) 
426 TRANSFER ABOTE 転送 が 中 断 し た 。 受信 を 拒否 され た ) 
450 NOT AVAILABLEK ファ イル が 使用 不能 ) 

451 LOCAL ERR コマ ンド を 中 断 し た 。 ロー カル エラ ー) 

452 FS FULI( ファ イル シス テム が 満杯 ) 

502 NOT IMPLEMENTEE コマ ンド は 実装 され て いな い ) 

504 NOT IMPLEMENTE コマ ンド の パラ メー タ が 実装 され て いな い ) 
550 NOT AVAILABLE ファ イル が 使用 不能 ) 

200 OK コマ ンド は 成功 し た ) 


・get 


get ぐ SP ツ > 絶対 パス ファ イル 名 改行 > 
get ぐ SP> < ファ イル 名 > マズ 改 行 > 


指定 し た ファ イル 名 の ファ イル を XMODEM で 取り 出す 。 
パラ メー タ : 


絶対 パス ファ イル 名 
< ファ イル 名 カレ ント ディ レク トリ の ファ イル 名 ) 
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レス ポン スコ ー ド : 

125 STARTING コマ ンド は 受け 付け られ た 。 転送 を 開始 する ) 

450 NOT AVAILABLRER ファ イル が 使用 不能 ) 

451 LOCAL ERR コマ ンド を 中 断 し た 。 ロー カル エラ ー ) 

452 FS FULI( ファ イル シス テム が 満杯 ) 

502 NOT IMPLEMENTEE コマ ンド は 実装 され て いな い ) 

504 NOT IMPLEMENTE コマ ンド の パラ メー タ が 実装 され て いな い ) 
550 NOT AVAILABLE ファ イル が 使用 不能 ) 

553 NOT AVAILABLE ファ イル 名 が 許さ れ て いな い ) 

200 OK コマ ンド は 成功 し た ) 


・delete 


delete <SP> ご 絶対 パス ファ イル 名 > 改行 > 
delete ぐ SP> < ファ イル 名 改行 > 


指定 し た ファ イル 名 の ファ イル を 削除 する 。 空き エリ ア は デフ ラグ され る まで 回 収 さ れ な い 。 


パラ メー タ : 
絶対 パス ファ イル 名 
< ファ イル 名 カレ ント ディ レク トリ の ファ イル 名 ) 


レス ポン スコ ー ド : 

450 NOT AVAILABLE ファ イル が 使用 不能 ) 

451 LOCAL ERR コマ ンド を 中 断 し た 。 ロー カル エラ ー ) 

502 NOT IMPLEMENTE コマ ンド は 実装 され て いな い ) 

504 NOT IMPLEMENTE コマ ンド の パラ メー タ が 実装 され て いな い ) 
550 NOT AVAILABLEK ファ イル が 使用 不能 ) 

553 NOT AVAILABLEK ファ イル 名 が 許さ れ て いな い ) 

200 OK( コマ ンド は 成功 し た ) 


~ eXeC 


( 形式 1) 
exec ぐ SP> 絶対 パス ファ イル 名 >[ パラ メー タン] 改行 > 
exec ぐ SP> < ファ イル 名 >[ パラ メー タツ] ご 改行 > 


( 形式 2) 
絶対 パス ファ イル 名 >[ て パラ メー タン ] 改行 
ベ フ ァイル 名 >[ パラ メー タン] 改行 > 


指定 し た ファ イル 名 の ファ イル を 実行 す ダ る ファ イル シス テム 上 の コマ ンド を 先 に サー チ し 、 失敗 
し た 場合 内 部 コマ ンド を サー チ す る )。 


パラ メー タ : 
絶対 パス ファ イル 名 
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< ファ イル 名 カレ ント ディ レク トリ 上 の ファ イル 名 。/ram0 の と き は exec に 失敗 ) 
て パラ メー タツ ( 文字 列 ま た は クオ ー ト 文字 列 。 複数 パラ メー タ の 場合 は スペ ー ス で 区 切る ) 


レス ポン スコ ー- ド : 

450 NOT AVAILABLE ファ イル が 使用 不能 ) 

451 LOCAL ERR コマ ンド を 中 断 し た 。 ロー カル エラ ー ) 

502 NOT IMPLEMENTE コマ ンド は 実装 され て いな い ) 

504 NOT IMPLEMENTED コマ ンド の パラ メー タ が 実装 され て いな い ) 
550 NOT AVAILABLEK ファ イル が 使用 不能 ) 

553 NOT AVAILABLE( ファ イル 名 が 許さ れ て いな い ) 

200 OK( コマ ンド は 成功 し た ) 


・reboot 
rebooT < ぐ SP> < 整数 ] ご 改行 
指定 秒 数 後に リブ ー ト する 指定 秒 数 まで は リブ ー ト メッ セー ジ を 表示 )。 


パラ メー タ : 
ぐ 秒 数 メ リブ - 下 まで の 秒 数 。 省略 時 は 1 秒 ) 


レス ポン スコ ー ド : 

451 LOCAL ERR コマ ンド を 中 断 し た 。 ロー カル エラ ー) 
502 NOT IMPLEMENTED コマ ンド は 実装 され て いな い ) 
成功 時 は 返事 な オープニング) 


・ls 
ls [ <SP> -IL <SP> -dI <SP> -ld][ <SP> 絶対 パス ディ レク トリ 名 >] ご 改行 > 
指定 し た ファ イル シス テム 上 の ファ イル 一覧 を テキ スト デー タ と し て 返す 。 


パラ メー タ : 

絶対 パス ディ レク トリ 名 /om0 ま た は /rom0/ ハー ド ファ イル シス テム #O、/famO ま た は 
/am0/ ソフ ト フ ァイル シス テム #O、 省略 され た 場合 カレ ント デ 
ィ レ クト リ ) 


レス ポン スコ ー ド : 

125 STARTING( コマ ンド は 受け 付け られ た 。 転送 を 開始 する ) 

451 LOCAL ERR コマ ンド を 中 断 し た 。 ロー カル エラ ー ) 

502 NOT IMPLEMENTE コマ ンド は 実装 され て いな い ) 

504 NOT IMPLEMENTE コマ ンド の パラ メー タ が 実装 され て いな い ) 
200 OK( コマ ンド は 成功 し た ) 
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・ dir 
dir [ < く SP ご 絶対 パス ディ レク トリ 名 >] 改行 
指定 し た ファ イル シス テム 上 の ファ イル 一 覧 を テキ スト デー タ と し て 返す 。 


パラ メー タ : 

絶対 パス ディ レク トリ 名 /fom0 ま た は /rom0/ ハー ド ファ イル シス テム # が 0、/fam0O ま た は 
/am0/ ソフ ト フ ァイル シス テム #O、 省略 され た 場合 カレ ント デ 
ィ レ クト リ ) 


レス ポン スコ ー ド : 

125 STARTING コマ ンド は 受け 付け られ た 。 転送 を 開始 する ) 

451 LOCAL ERR コマ ンド を 中 断 し た 。 ロー カル エラ ー ) 

502 NOT IMPLEMENTE コマ ンド は 実装 され て いな い ) 

504 NOT IMPLEMENTE コマ ンド の パラ メー タ が 実装 され て いな い ) 
200 OK( コマ ンド は 成功 し た ) 


・df 
df [ ぐ SP> マフ ァイル シス テム 名 >] 改行 > 


ファ イル シス テム の 情報 一 覧 を テキ スト デー タ と し て 返す 。 ファ イル シス テム 名 が 指定 され た 場合 、 
その ファ イル シス テム の み 。 


パラ メー タ : 
< く フ ァイル シス テム 名 >( romOC ハー ド フ ァイル シス テム #O、 ramO ソフ スト フ ァイル シス テム #0) 


レス ポン スコ - : 
125 STARTING コマ ンド は 受け 付け られ た 。 転送 を 開始 する ) 
451 LOCAL ERR コマ ンド を 中 断 し た 。 ロー カル エラ ー ) 
502 NOT IMPLEMENTEU コマ ンド は 実装 され て いな い ) 
200 OK( コマ ンド は 成功 し た ) 
・ newfs 
newfs <SP> < ファ イル シス テム 名 窟 ご 改行 > 
指定 し た ファ イル シス テム を 初期 化す る 。 


パラ メー タ : 
< ファ イル シス テム 名 romOC ハー ド フ ァイル シス テム #0、 ramO ソフ ト フ ァイル シス テム #0O) 


レス ポン スコ - : 


451 LOCAL ERR コマ ンド を 中 断 し た 。 ロー カル エラ ー ) 
502 NOT IMPLEMENTEE コマ ンド は 実装 され て いな い ) 


161 


付録 D その 他 の 仕様 


504 NOT IMPLEMENTE コマ ンド の パラ メー タ が 実装 され て いな い ) 
200 OK( コマ ンド は 成功 し た ) 


・defrag 
defrag く SP < ファ イル シス テム 名 > 改行 > 
指定 し た ファ イル シス テム を デフ ラグ する 。 


パラ メー タ : 
< く フ ァイル シス テム 名 romOC ハー ド フ ァイル シス テム #0O、 ramO ソフ ト フ ァイル シス テム #0O) 


レス ポン スコ ー ド : 

451 LOCAL ERR コマ ンド を 中 断 し た 。 ロー カル エラ ー ) 

502 NOT IMPLEMENTED コマ ンド は 実装 され て いな い ) 

504 NOT IMPLEMENTE コマ ンド の パラ メー タ が 実装 され て いな い ) 
200 OK( コマ ンド は 成功 し た ) 


・ Tenam1e 


rename ぐ SP> ご 絶対 パス ファ イル 名 > <SP> ぐ 新 ファ イル 名 改行 > 
rename ぐ SP> < ファ イル 名 > < ぐ SP> ご 新 フ ァイル 名 > 改行 > 


指定 し た ファ イル 名 の ファ イル 名 を 変更 する 。 


パラ メー タ : 

絶対 パス ファ イル 名 

< ファ イル 名 カレ ント ディ レク トリ 上 の ファ イル 名 ) 
ご 新 フ ァイル 名 文字 列 ) 


レス ポン スコ ー ド : 

450 NOT AVAILABLE( ファ イル が 使用 不能 ) 

451 LOCAL ERR コマ ンド を 中 断 し た 。 ロー カル エラ ー ) 

502 NOT IMPLEMENTE コマ ンド は 実装 され て いな い ) 

504 NOT IMPLEMENTE コマ ンド の パラ メー タ が 実装 され て いな い ) 
553 NOT AVAILABLE ファ イル 名 が 許さ れ て いな い ) 

200 OK( コマ ンド は 成功 し た ) 


・sDeed 
speed[ < ぐ SP> < スピ ー ド >] < 改行 > 


通信 速度 を 設定 する 。 て スピ ー ド パラ メー タ が 無い と き は 、 現在 の 状態 を テキ スト デー タ で 返 
す 。 
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リモ ー ト シェ ル 通 信 プ ロト コル 仕様 


パラ メー タ : 
< スピ ー ド 9600 ま た は 38400。 省略 時 は 現在 の スピ ー ド を 返す ) 


レス ポン スコ ー ド : 

125 STARTING コマ ンド は 受け 付け られ た 。 転送 を 開始 する ) 

451 LOCAL ERR コマ ンド を 中 断 し た 。 ロー カル エラ ー ) 

502 NOT IMPLEMENTED コマ ンド は 実装 され て いな い ) 

504 NOT IMPLEMENTE コマ ンド の パラ メー タ が 実装 され て いな い ) 
200 OK( コマ ンド は 成功 し た ) 


・ date 


date [ ぐ SP> ぐ 日 付 時 間 >] 改行 > 


RTC の 日 付 、 時 間 を 設定 する 。 ぐ 日 付 時 間 シ パラ メー タ が 無い と き は 、 現在 の 状態 を テキ ス 
ト デ ー タ で 返す 。 


パラ メー タ : 
日 付 時 間 >( YYYYMMDDhhmm.ss) 


レス ポン スコ ー ド : 

125 STARTING コマ ンド は 受け 付け られ た 。 転送 を 開始 する ) 
451 LOCAL ERR コマ ンド を 中 断 し た 。 ロー カル エラ ー ) 

501 SYNTAX ERR パラ メー タ に 文法 エラ ー が ある ) 

502 NOT IMPLEMENTE コマ ンド は 実装 され て いな い ) 

200 OK( コマ ンド は 成功 し た 


~ CODY 


copy く SP> < ソー ス 絶 対 パ ス フ ァ イル 名 > ぐ SP ツ > 絶対 パス ディ レク トリ 名 > 改行 
copy くべ SP> < ソー ス 絶 対 パ ス フ ァ イル 名 > ぐ SP>> ご 絶対 パス ファ イル 名 > 改行 > 
copy く SP> < ソー ス フ ァ イル 名 > <SP>> ご 絶対 パス ディ レク トリ 名 > 改行 > 

copy く SP> < ソー ス フ ァ イル 名 > <SP ツ > ご 絶対 パス ファ イル 名 > 改行 

copy く SP> < ソー ス 絶 対 パ ス フ ァ イル 名 > ぐ SP> < ディ レク トリ 名 > 改行 > 

copy く SP> < ソー ス 絶 対 パ ス フ ァ イル 名 > < く SP> < ファ イル 名 > 改行 > 

copy く SP> < ソ ー ス ファ イル 名 > てく SP> ディ レク トリ 名 改行 > 

copy く SP> く < ソ ー ス ファ イル 名 > て SP> < ファ イル 名 > て 改行 > 


指定 し た ファ イル を コピ ー す る 。 


パラ メー タ : 

< く 絶 対 パ ス フ ァ イル 名 

絶対 パス ディ レク トリ 名 >( /omO: ハー ド ファ イル シス テム #0O、/famO ソフ ト フ ァイル シ 
ステ ム #0) 

< ファ イル 名 > 
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付録 D その 他 の 仕様 


リモ ー ト シェ ル 通 信 プ ロト コル 仕様 


レス ポン スコ ー ド : 200 OK( コマ ンド は 成功 し た ) 

450 NOT AVAILABLEK ファ イル が 使用 不能 

451 LOCAL ERR コマ ンド を 中 断 し た 。 ロー カル エラ ー) ・cd 

502 NOT IMPLEMENTER コマ ンド は 実装 され て いな い ) 

504 NOT IMPLEMENTE コマ ンド の パラ メー タ が 実装 され て いな い ) cd [ <SP> 絶対 パス ディ レク トリ 名 >] ご 改行 > 
553 NOT AVAILABLE ファ イル 名 が 許さ れ て いな い ) cd [ <SP> < ディ レク トリ 名 >] ご 改行 > 


200 OK( コマ ンド は 成功 し た ) 


カレ ント デア イ レク トリ を 指定 し た ギィ レク トリ に 変更 する 


・setinfo 
パラ メー タ : 
setinfo く SP ン > < 絶対 パス ファ イル 名 > <SP ツ > ご 説明 > て 改行 > ぐ 絶 対 パ ス デ ィ レ クト リ 名 >( romQ ハー ド フ ァイル シス テム #0、 ramQ ソト ファ イル シス テム ) 
setinfo ぐ SP> < ファ イル 名 > ぐ SP> マ 説 明 > 改行 
レス ポン スコ - : 
指定 し た ファ イル 名 の 説明 を 変更 する 最大 24 バ イト 。 スペ ー ス を 許す 。 450 NOT AVAILABLE( ファ イル が 使用 不能 ) 


451 LOCAL ERR コマ ンド を 中 断 し た 。 ロー カル エラ ー ) 


パラ メー タ : 502 NOT IMPLEMENTEU コマ ンド は 実装 され て いな い 
ご 絶対 パス ファ イル 名 504 NOT IMPLEMENTE コマ ンド の パラ メー タ が 実装 され て いな い ) 
< ファ イル 名 カレ ント ディ レク トリ 上 の ファ イル 名 ) 553 NOT AVAILABLE ファ イル 名 が 許さ れ て いな い ) 
ご 説明 メ 文字 列 ま た は クオ ー ト 文字 列 ) 200 OK コマ ンド は 成功 し た ) 

レス ポン スコ - : ・Dwd 

450 NOT AVAILABLE ファ イル が 使用 不能 ) 

451 LOCAL ERR コマ ンド を 中 断 し た 。 ロー カル エラ ー) pwd ご 改行 > 

502 NOT IMPLEMENTEU コマ ンド は 実装 され て いな い ) 

504 NOT IMPLEMENTE コマ ンド の パラ メー タ が 実装 され て いな い ) カレ ント ギレ クト リ を 返す 。 

553 NOT AVAILABLE( ファ イル 名 が 許さ れ て いな い ) 

200 OK コマ ンド は 成功 し た ) レス ポン スコ ー ド : 


125 STARTING コマ ンド は 受け 付け られ た 。 転送 を 開始 する ) 


・chmod 451 LOCAL ERR コマ ンド を 中 断 し た 。 ロー カル エラ ー) 
501 SYNTAX ERR パラ メー タ に 文法 エラ ー が ある ) 
chmod < く SP ツ > 絶対 パス ファ イル 名 > <SP> < ファ イル モー ドン 改行 502 NOT IMPLEMENTER コマ ンド は 実装 され て いな い ) 
chmod <SP> < ファ イル 名 > <SP> < ファ イル モー ドン 改行 200 OKK コマ ンド は 成功 し た ) 
指定 し た 絶対 パス ファ イル 名 の ファ イル モー ド を 変更 する 。 還 テ キス ト デー タ 転送 
テキ スト デー タ の 転送 は 、 継続 応答 で ある 100 番 台 の 応答 の あと .”" の み の 行 ま で に 挟ま れ た 
パラ メー タ : テキ スト と し て 実現 され る 。 テキ スト デー タ そ の も の の 行頭 の ' ." ば ' .… に エス ケー プ し て 送信 する 。 
絶対 パス ファ イル 名 > 受信 側 は これ を ぞ '.”" に デコ ー ド する 必要 が ある 。 
< べ フ ァイル 名 カレ ント ディ レク トリ 上 の ファ イル 名 ) 
< ファ イル モー ド 8 進数 0 か ら 始 まる 数 値 ) ま た は 16 進 数 0 以外 か ら 始ま る 数 値 ) 例 : 
レス ポン スコ ー ド : [ プロ トコ ル 上 デー タ ] 
450 NOT AVAILABLE ファ イル が 使用 不能 ) 
451 LOCAL ERR コマ ンド を 中 断 し た 。 ロー カル エラ ー) meg HELO ご 改行 > : コマ ンド ( リク エス ト 側 送 信 ) 
502 NOT IMPLEMENTEU コマ ンド は 実装 され て いな い ) 125 STARTTNG ぐ 改 行 > : 継続 応答 
504 NOT IMPLEMENTE コマ ンド の パラ メー タ が 実装 され て いな い ) HErO. 改行 > : テキ スト デー タ 
553 NOT AVAILABLE ファ イル 名 が 許さ れ て いな い ) WonderWitch 1.0.0 改行 : テキ スト デー タ 
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FreyaOoS 1.0.0 改行 > : テキ スト デー タ 
FreyaBTOS 1.0.0 改行 》 : テキ スト デー タ 
c/w Meg xxxx 改行 : テキ スト デー タ 
Owner xxxx 改行 : テキ スト デー タ 
. ぐ 改行 : EOT 
200 OK 改行 : 結果 応答 

[ テキ スト デー タ ] 


HErO. ご 改行 > 
WonderWitoch 1.0.0 改行 
FreyaOS 1.0.0 改行 > 
FreyaBTOS 1.0.0 改行 > 
c/w Meg xxxx 改行 
Owner xxxx 改行 


弄 フ ァイル バイ ナリ デー タ ) 転 送 


ファ イル 転送 は 、 継続 応答 で ある 100 番 背 受信 時 ) ま た は 300 番 令 送信 時 ) の 応答 の あと 、 
XMODEM 転 送 行う 。 XMODEM で 転送 され る ファ イル の フォ ー マ ッ ト に つい て ば D.1.6 プレ ゼ 


ン テ ー シ ョ ン 層 」 の WonderWitch 転 送 形式 ファ イル フォ ー マ ッ ト 」 を 参照 。 
例 1: 


[ プロ トコ ル 上 デー タ ] 


meg ン ご put /romO 改行 > : コマ ンド ( リク エス ト 側 送信 ) 
350 FURTHER TNFO 改行 : 継続 応答 

( xMopgM 受信 ) : バイ ナリ デー タ 

200 OK 改行 : 結果 応答 


例 2: 
[ プロ トコ ル 上 デー タ ] 


meg get /rom0/SomeFi1e 改行 : コマ ンド ( リク エス ト 側 送信 ) 


125 STARTTNG ご 改 行 > : 継続 応答 
( xMopgM 送信 ) : バイ ナリ デー タ 
200 OK 改行 : 結果 応答 


例 3: 
[ プロ トコ ル 上 デー タ ] 


meg send /romO 改行 : コマ ンド ( リク エス ト 側 送 信 ) 
426 TRANSFER ABOTED 改行 : 受信 側 拒否 
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D.1.6 プレ ゼン テー ショ ン 層 
還 WonderWitch 転 送 形 式 ファ イル フォ ー マ ッ ト 


WonderWitch 転 送 形 式 フ ァイル の 先頭 1283 バ イト に は ファ イル の 共通 ヘッ ダ 情報 が 格納 され 、 
最初 の XMODEM 転 送 ブ ロッ block #0) と し て 使用 され る 。 その 後に 続い て ファ イル 本 体 デ 


ー タ が 格納 され る 。 最後 の 転送 ブロ ッ ク に 余り が ある 場合 、 OxFF で パ デ ィ ン グ さ れる 。 


・WonderWitch 転 送 形 式 フ ァイル 


位置 内 容 

0-3 マジ ッ ク ナ ン バ “ 者 ws"。16 進 で ば "Ox21 Ox23 0x73 0x77”) 
4- 63 reserve 通常 は FFH で パ デ ィ ン グ ) 

64 - 127 ファ イル 情報 filesys.h で 定義 され る fent_t の 内 容 そ の も の ) 
128 - EOF ファ イル 本 集 リソー ス が ある 場合 リソー ス を 含む ) 

・ フ ァイル 転送 時 の ブロ ッ ク 


4bytes マジ ッ ク ナ ン バ ー 較 


#ws | reserve 60bytes 


(通常 は OxFF で padding) | block #0 図 
(128bytes) 


ファ イル 情報 64bytes 


ファ イル 本 体 128bytes block 


ファ イル 本 体 128bytes |block #2 


國 レ スポ ンス テキ スト デー タフ ォ ー マ ッ ト 
・stty 


echo on 時 : 


ecCho 


echo off 時 : 


ーeCho 


・HELO 
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E ュ 1ename d エ と wxtk 三 S1zG 七 1me deGSC エ 1p キ ュ on 


・dir / ls -| 
モ o モ a1 xxx Ei1es 
d 
r 一 読み 込み 可能 
w 書き 込み 可能 
x 一 実行 可能 


= - ス トリ ー ム アク セス 可能 フラ 外 デー タ を 読む ) 


size - 10 進 右 揃 え ULONGMAX unsigned long) 
time - 文字 列 YYYY-MM-DD hh:mm:s 後述 の datse コ マン ド 参照 ) 


・df 
Fi1esystem Size 
Oo 64 
ェ rom0 327680 
ram0 65536 
(aa ユエ 1 = sze 一 uS@ed) 
・date 
YYYYーMM-DD hh:mm:ss 
固 プ ロン プ ト 


Shell が Meg の 場合 meg" と な る 。 


D.1.7 参考 資料 
・FTP RFC 日 本 語 版 


Used 
64 
116992 
12160 


ム Aai1ab1e 
0 

210688 
53376 


http:/hp.vector.co.jp/authors パ A002682/rfc959j.htm 


・XMODEM 


ーd: ディ レク トリ ファ イル 、i: イン ダイ レク トラ イブ ラリ 、 上 1 シン ボリ ッ ク リ ンク 


CapaC ュ 上 En モ Eries 


100$ 4 
35 も 128 
18S 64 


ftp://ftp.std.com/obi。tandards/FileTransfer/YYMODEM8.DOC.1.Z 


http:/Aww.st rim.or.jp/ phinloda /proto2.html 
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フォ ント 

D.2 フォ ント 

D.2.1 ASCII フォ ント 
O123456789ABCDEF 
0| | ご 画 百 者 下 吉 ロロ 回 時 瑞 再 
IE ELTIEEE 
還 LEEE に ELTE ETamm 直 回 
cl PE EE だ 」HEHE4 三 的 
4 ag[ 目 | 
2 EE 民生 1 WW 記 上 い テ |ー 
6 + mp 回 己 hi に 1 mmm 
に 避 TLDITE に TTF 間 邊 詳 im 門 
ASCII コ ー ド に 対応 する 表示 可能 な フォ ント 表 8X ボッ ト ) 


・ 表 の 見 方 


最上 桁 は ビッ ト パタ ー ン の 下位 4 ピット を 、 最 左 列 は 上 位 3 ビ ッ ト を それ ぞ れ 表し ます 。 例え ば 、 


4b ば 'K( Ox4b) に 対応 し ます 。 


WonderWitch で 利用 可能 な 漢字 フォ ント が 含ま れ て いる コー ド 範 


囲 を 、JIS コー ド で 示し ま 


D.2.2 漢字 フォ ント 

す 。 
2121-217e| 3021-307e 
2221-222eK| 3121-317e 
223a-2241 区 | 3221-327e 
224a-2250K| 3321-337e 
225c-226a| 3421-347e 
2272-2279| 3521-357e 
227e-227e| 3621-367e 
2330-2339 区 | 372 や 77e 
2341-235a| 3821-387e 
2361-237a| 3921-397e 
2421-2473| 3a21-3a7ek 
2521-2576K| 3b21-3b7e 
2621-2638| 3c21-3c7ek 
2641-2658| 3d21-3d7ek 
2721-2741| 3e21-3e7e 
2751-2771| 3f21-3f7e 
2821-2840 


4021-407e 
4121-417e 
4221-427e 
4321-437e 
4421-447e 
4521-457e 
4621-467e 
47 机 477e 
4821-487e 
4921-497e 
4a21-4a7e 
4b21-4b7e 
4c21-4c7e 
4d21-4d7e 
4e21-4e7e 
4f21-4f53 


k 


M 
k 
k 


5021-507e 
5121-517e 
5221-527e 
5321-537e 
5421-547e 
5521-557e 
5621-567e 
5 狗 I-577ek 
5821-587e 
5921-597e 
5a21-5a7e 
5b21-5b7e 
5c21-5c7e 
5d21-5d7e 
5e21-5e7e 
5f21-5f7e 


6021-607e 
6121-617e 
6221-627e 区 
6321-637e 
6421-647e 区 
6521-657e 
6621-667e 
6721-677e 
6821-687e 
6921-697e 区 
6a21-6a7e 区 
6b21-6b7e 
6c21-6c7e 
6d21-6d7e 
6e21-6e7e 区 
6f21-6f7e 


7021-707e 
7121-717e 
7221-727e 
7321-737e 
7421-7424 
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_printf_buf 
( None) PROCOCCCEPEPISHEHTEFEWPEHPHErEirtirirrrrerrrl 
SMEG_AUTORUN ドド ドド に 27, 28 
SMEGIKEYIBIND Yen 27 
中 DIINiSUGCRUA2WGHBORt3IN LGAGD4004032TIeNAYKBDa-KdR622N629 5 51 
で 電 COSUMMOMMASADIODMCS0JAMCUMGOOLMOCOCIOOD 50 
Oo GO20YAiAPBOIRA32GAAGSD494I97ApxdieUYtNDaptdft22t6298 51 
2 GMRGORAZGIRKGHONNAG2SNG2M20UAGI024NR3SNSMEN2NEISGGIGI6 ま の 51 
2 KIBIOORNBIRPOUXE SKIG08RSDiAixd0373PSSKEGUCIRGISGM2 50 
NAND BENGNAMECNuD2N0BKGAURNII2NR SNEdD524GGCGC609 あ 6 51 
30 KBURAA/DNeTENY2IGOWG2INROSOKXA0303PSOYEIGVRGSL2R0B2 50 
(SGll MKGUG19MOCNKGYEAMI2SROGIPODKKSMtid20I2SG 31 
[ 英文 ] 
BB 大 NIKKI 同上 BBEOGK TOWotwhirwormwedinneste 51 
BANK_GET_LMAP oo 49 
BANK_READ_BLOCK ドド ドド ドッ に 50 
BANK_READ_BYTE ドー ドー ドド トド 49 
BANK_READ_WORD ・・‥ ド ドー ドド に 150 
BANK_SET_MAP ・148 
BANK_WRITE_BLOCK ドド ドド ッッ 51 
BANK_WRIT 記 BY 上 條 erreefnueniewlotis 49 
BANK_WRITE_WORD ・ ド ドド トッ 50 
BGM シ ー ケ ンス デー ター に TI 155 
EN YUKOBDDARUOLSterGriigeBtGIEAGUHKSYSrEveaydte7ee7a9 62 
BIOS_INLINE マ クロ ーー ドド 63 
bmpcnv ・153 
(0 1 119e oO 陣 CMA00EDSOEDOLKGCI が EAAMOCACYRO 58 
ele|ld MEGASOHMCNOEANDUMACEXODAM れ 30DHNOEU の り 69 89 
eilrtee|0 0 隊 AMOEAIEMDOUKGON は DLKANAMAOOLKOODO 89 
IGG KGG0DOWGS3rPGe4Kt4RGu)4MKINOW YA4c4S| 83 
OIOSG0) ROSECGDSTSGISatB(GHSG0EA9IG の SE 
(OOIM が が MODSNWKON0BNOKD8DG GNUGDB2SDEGG0SCNSKORS 
COMM_CLOSE 
COMM_GET_BAUDRATE ドド ドド 35 
COMM_GET_CANCEL_KEY ドド ドド ーー 35 
GOMIMLOPEN 9NRaeoimtemdmednneiiarrte bited 131 
COMM_RECEIVE_BLOCK ドド ドー 134 
COMM_RECEIVE_CHAR ・ ド ドド ドー 32 
COMM_RECEIVE_WITH_TIMEOUT …・……・ 133 
COMM_SEND_BLOCK ドド 133 
COMM_SEND_CHAR ドド ドド トド 32 
COMM_SEND_STRING ・ ド ドド ドド 33 
COMM_SET_BAUDRATE ・・ ド ドド ドド 34 
COMM_SET_CANCEL_KEY ドド ドド ドー 35 
COMM_SET_TIMEOUT ・…・ 


COMM_XMODEM 
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dc19( 了 MOUMLUTMDMLEGUHYCOUDKOD 
CURSOR_DISPLAY 

CURSOR_GET_LOCATION ーー 121 
CURSOR_GET_TYPE ーー 122 
CURSOR_SET_LOCATION ーー 121 
CURSOR_SET_TYPE ーー 122 
CURSOR_STATUS ーー 121 
C ソ ー ス ファ イル ーー ドー ドー ドー 50 
C ヘ ッ ダ ファ イル ドド ドド に ror 50 
datetime_t 構 造 体 ・ ド ゆー ドド ドド 
DISPLAY_CONTROL …… ド ドド ーーーーーー 
DISPLAY_STATUS ドー ドー ドド ドド ーー ドー 
E_FS FILE_NOT_ FOUND ーー ドー 
E_FS FILE_NOT_OPEN …・ ・ 
E_FS_NO_SPACE_LEFT ドド ーーー 
E_FS_OUT_OF_BOUND ドド ーー 
E_FS_PERMISSION_DENIED ・…… ド ーー 89 
E_FS_SUCCESS …ー ド ーー ドー ドー ドー ドー 89 
ETC マ ー ク ーー ドー ドー 12 


BKG) 923 が SDaNdNarP3OANo73ISIES CNNRYGIENS4SSUASGEHRTWKG05 人 


BS 7252INWWBCO9STB7U2ORNEVSHE3HESURNNIRCAGEYS2CGUEONNBKSTEDRt27AURN 
filepath_t 構 造 体 ・ * 
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